Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeutils@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 253 insertions, 0 deletions

diff --git a/khexedit/lib/kbuffercolumn.h b/khexedit/lib/kbuffercolumn.h
new file mode 100644
index 0000000..76ed8bc
--- /dev/null
+++ b/khexedit/lib/kbuffercolumn.h
@@ -0,0 +1,253 @@
+/***************************************************************************
+                          kbuffercolumn.h  -  description
+                             -------------------
+    begin                : Mit Mai 14 2003
+    copyright            : (C) 2003 by Friedrich W. H. Kossebau
+    email                : Friedrich.W.H@Kossebau.de
+ ***************************************************************************/
+
+/***************************************************************************
+ *                                                                         *
+ *   This library is free software; you can redistribute it and/or         *
+ *   modify it under the terms of the GNU Library General Public           *
+ *   License version 2 as published by the Free Software Foundation.       *
+ *                                                                         *
+ ***************************************************************************/
+
+
+#ifndef KHE_KBUFFERCOLUMN_H
+#define KHE_KBUFFERCOLUMN_H
+
+// lib specific
+#include "khe.h"
+#include "kdatabuffer.h"
+#include "khechar.h"
+#include "kcolumn.h"
+#include "kbufferlayout.h"
+#include "ksection.h"
+
+class QPainter;
+class QColor;
+
+namespace KHE
+{
+
+// class KHexEdit;
+class KBufferRanges;
+class KCharCodec;
+
+const int NoByteFound = -1;
+
+/** base class of all buffer column displayers
+  * holds all information about the vertical layout of a buffer column
+  * knows how to paint the data and the editing things (focus, cursor, selection)
+  * but does not offer
+  *
+  *@author Friedrich W. H. Kossebauint KBufferColumn::posOfX( KPixelX PX, bool *ToTheRightFlag ) const
+  */
+class KBufferColumn : public KColumn
+{
+  public:
+    enum KFrameStyle { Frame, Left, Right };
+  public:
+    KBufferColumn( KColumnsView/*KHexEdit*/ *HE, KDataBuffer *B, KBufferLayout *L, KBufferRanges *R );
+    virtual ~KBufferColumn();
+
+
+  public: // KColumn-API
+    virtual void paintFirstLine( QPainter *P, KPixelXs Xs, int FirstLine );
+    virtual void paintNextLine( QPainter *P );
+
+  public:
+    void preparePainting( KPixelXs Xs );
+
+  public:
+    void paintLine( QPainter *P, int Line );
+    void paintPositions( QPainter *P, int Line, KSection Positions );
+    /** paints a cursor based on the type of the byte.
+      * @param Index Index of the byte to paint the cursor for. If -1 a space is used as char.
+      */
+    void paintCursor( QPainter *P, int Index );
+    /** paints the byte with background.
+      * @param Index Index of the byte to paint. If -1 only the background is painted.
+      */
+    void paintByte( QPainter *P, int Index );
+    /** paints the byte with background and a frame around.
+      * @param Index Index of the byte to paint the frame for. If -1 a space is used as char.
+      * @param Style the style of the framing
+      */
+    void paintFramedByte( QPainter *P, int Index, KFrameStyle Style );
+
+
+  public: // modification access
+    /** sets the spacing in the hex column
+      * @param ByteSpacingW spacing between the bytes in pixels
+      * @param NewNoOfGroupedBytes numbers of grouped bytes, 0 means no grouping
+      * @param GroupSpacingW spacing between the groups in pixels
+      * returns true if there was a change
+      */
+    bool setSpacing( KPixelX ByteSpacingW, int NewNoOfGroupedBytes = 0, KPixelX GroupSpacingW = 0 );
+    /** sets the spacing between the bytes in the hex column
+      * @param ByteSpacingW spacing between the bytes in pixels
+      * returns true if there was a change
+      */
+    bool setByteSpacingWidth( KPixelX ByteSpacingW );
+    /** sets the number of grouped bytes in the hex column
+      * @param NewNoOfGroupedBytes numbers of grouped bytes, 0 means no grouping
+      * returns true if there was a change
+      */
+    bool setNoOfGroupedBytes( int NewNoOfGroupedBytes );
+    /** sets the spacing between the groups of bytes in the hex column
+      * @param GroupSpacingW spacing between the groups in pixels
+      * returns true if there was a change
+      */
+    bool setGroupSpacingWidth( KPixelX GroupSpacingW );
+    /** sets width of digits and recalculates depend sizes
+      * returns true if there was a change
+      */
+    bool setDigitWidth( KPixelX DW );
+    /** sets the metrics of the used font
+      * @param NewDigitWidth the new width of a digit
+      * @param NewDigitBaseLine the new baseline of the digits
+      */
+    void setMetrics( KPixelX NewDigitWidth, KPixelY NewDigitBaseLine );
+    /** */
+    void set( KDataBuffer *B );
+    /** creates new buffer for x-values; to be called on any change of NoOfBytesPerLine or metrics */
+    void resetXBuffer();
+    /** sets the codec to be used by the char column. */
+    void setCodec( KCharCodec *C );
+
+  public: // functional logic
+    /** returns byte positions covered by pixels with absolute x-coord x */
+    KSection posOfX( KPixelX x, KPixelX w ) const;
+    /** returns byte pos at pixel with absolute x-coord x */
+    int posOfX( KPixelX x ) const;
+    /** returns byte pos at pixel with absolute x-coord x, and sets the flag to true if we are closer to the right */
+    int magPosOfX( KPixelX PX ) const;
+    /** returns absolute x-coord of byte at position Pos */
+    KPixelX xOfPos( int Pos ) const;
+    /** returns right absolute x-coord of byte at position Pos */
+    KPixelX rightXOfPos( int Pos ) const;
+    /** returns byte pos at pixel with relative x-coord x */
+    int posOfRelX( KPixelX x ) const;
+    /** returns byte positions covered by pixels with relative x-coord x */
+    KSection posOfRelX( KPixelX x, KPixelX w ) const;
+    /** returns relative x-coord of byte at position Pos */
+    KPixelX relXOfPos( int Pos ) const;
+    /** returns right relative x-coord of byte at position Pos */
+    KPixelX relRightXOfPos( int Pos ) const;
+    /** returns the positions that overlap with the absolute x-coords */
+    KSection visiblePositions( KPixelX x, KPixelX w ) const;
+    /** returns the */
+    KPixelXs wideXPixelsOfPos( KSection Positions ) const;
+    /** */
+    KPixelXs relWideXPixelsOfPos( KSection Positions ) const;
+
+  public: // value access
+    KPixelX byteWidth()                      const;
+    KPixelX digitWidth()                     const;
+    KPixelX groupSpacingWidth()              const;
+    KPixelX byteSpacingWidth()               const;
+    int noOfGroupedBytes()                   const;
+
+    int firstPos() const;
+    int lastPos()  const;
+    KSection visiblePositions() const;
+    const KBufferLayout *layout() const;
+    KCharCodec* codec() const;
+
+  protected:
+    /** */
+    void recalcX();
+    void recalcVerticalGridX();
+
+
+  protected: // API to be refined
+    /** default implementation simply prints the byte as ASCII */
+    virtual void drawByte( QPainter *P, char Byte, KHEChar B, const QColor &Color ) const;
+    /** default implementation sets byte width to one digit width */
+    virtual void recalcByteWidth();
+
+
+  protected:
+    void paintGrid( QPainter *P, KSection Range );
+    void paintPlain( QPainter *P, KSection Positions, int Index );
+    void paintSelection( QPainter *P, KSection Positions, int Index, int Flag );
+    void paintMarking( QPainter *P, KSection Positions, int Index, int Flag );
+    void paintRange( QPainter *P, const QColor &Color, KSection Positions, int Flag );
+
+    bool isSelected( KSection Range, KSection *Selection, unsigned int *Flag ) const;
+    bool isMarked( KSection Range, KSection *Marking, unsigned int *Flag ) const;
+
+
+  protected:
+    /** pointer to the buffer */
+    KDataBuffer *Buffer;
+    /** pointer to the layout */
+    const KBufferLayout *Layout;
+    /** pointer to the ranges */
+    KBufferRanges *Ranges;
+    /** */
+    KCharCodec *Codec;
+
+    /** */
+    KPixelX DigitWidth;
+    /** */
+    KPixelY DigitBaseLine;
+    /** */
+    KPixelX VerticalGridX;
+    /** */
+    bool VerticalGrid;
+
+  protected:  // individual data
+    /** total width of byte display in pixel */
+    KPixelX ByteWidth;
+    /** width of inserting cursor in pixel */
+    KPixelX CursorWidth;
+    /** size of the line margin */
+    KPixelX ByteSpacingWidth;
+    /** width of spacing in pixel */
+    KPixelX GroupSpacingWidth;
+
+    /** number of grouped bytes */
+    int NoOfGroupedBytes;
+
+    /** pointer to array with buffered positions (relative to column position)
+      * a spacing gets assigned to the left byte -> ...c|c|c |c|c...
+      */
+    KPixelX *PosX;
+    KPixelX *PosRightX;
+    /** index of right position */
+    int LastPos;
+
+
+  protected: // buffering drawing data
+    KSection PaintPositions;
+    int PaintLine;
+    KPixelX PaintX;
+    KPixelX PaintW;
+    int SpacingTrigger;
+};
+
+
+inline KPixelX KBufferColumn::byteWidth()         const { return ByteWidth; }
+inline KPixelX KBufferColumn::digitWidth()        const { return DigitWidth; }
+inline KPixelX KBufferColumn::byteSpacingWidth()  const { return ByteSpacingWidth; }
+inline KPixelX KBufferColumn::groupSpacingWidth() const { return GroupSpacingWidth; }
+
+inline int KBufferColumn::noOfGroupedBytes()      const { return NoOfGroupedBytes; }
+
+inline int KBufferColumn::firstPos() const { return PaintPositions.start(); }
+inline int KBufferColumn::lastPos()  const { return PaintPositions.end(); }
+inline KSection KBufferColumn::visiblePositions() const { return PaintPositions; }
+
+inline const KBufferLayout *KBufferColumn::layout() const { return Layout; }
+
+
+inline void KBufferColumn::setCodec( KCharCodec *C ) { Codec = C; }
+inline KCharCodec* KBufferColumn::codec() const { return Codec; }
+
+}
+
+#endif