summaryrefslogtreecommitdiffstats
path: root/khexedit/lib/kbuffercolumn.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit2bda8f7717adf28da4af0d34fb82f63d2868c31d (patch)
tree8d927b7b47a90c4adb646482a52613f58acd6f8c /khexedit/lib/kbuffercolumn.h
downloadtdeutils-2bda8f7717adf28da4af0d34fb82f63d2868c31d.tar.gz
tdeutils-2bda8f7717adf28da4af0d34fb82f63d2868c31d.zip
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
Diffstat (limited to 'khexedit/lib/kbuffercolumn.h')
-rw-r--r--khexedit/lib/kbuffercolumn.h253
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