MAN page from Mandrake Other XITE-3.3-3.i386.rpm

HISTOGRAM

Section: C Library Functions (3)
Updated: 16 Mar 1998
Index

NAME

Histogram - Widget class for histograms in XITE programs

APPLICATION HEADER FILE

CLASS HEADER FILE

CLASS

histogramWidgetClass

CLASS NAME

Histogram

SUPERCLASS

Core

DESCRIPTION

The Histogram widget is part of the XITE (X-based ImageProcessing Tools and Environment) software. It is used by thehistogram application window included with several of thedisplay programs supplied with XITE (and available via theximage toolkit).

See the documentation on the main XITE display programxshow(1)as well as the XITE ximage toolkit ximage(3)formore information on how this widget can be used in anapplication.

RESOURCES

Apart from the resources of the superclass:

XtNhistogramHistogram (class XtCHistogramHistogram)

Type: Pointer,Default: NULL

A reference to an integer array with histogram values.

XtNhistogramLength (class XtCHistogramLength)

Type: int,Default: NULL

Length of histogram and cumulative histogram arrays.

XtNhistogramTitle (class XtCHistogramTitle)

Type: Pointer,Default: NULL

Title of histogram. Used to form window manager decorationtitle.

XtNhistogramVisual (class XtCHistogramVisual)

Type: Pointer,Default: NULL

Visual of Histogram widget. See the "Xlib Programming Manual"by Adrian Nye (O'Reilly & Associates, Inc.), chapter 7 formore information about visuals.

XtNhistogramColormap (class XtCHistogramColormap)

Type: Pointer,Default: NULL

Colormap used by the histogram widget.

XtNhistogramImage (class XtCHistogramImage)

Type: Pointer,Default: NULL

A reference to the BIFF image data structure.

XtNhistogramBand (class XtCHistogramBand)

Type: Pointer,Default: NULL

A reference to the BIFF band data structure for which thishistogram is made.

XtNhistogramCrossing (class XtCCallback)

Type: XtCallbackList,Default: NULL

The functions on this callback list will be called by theCrossingaction function described below.

XtNhistogramButton (class XtCCallback)

Type: XtCallbackList,Default: NULL

The functions on this callback list may be called by theButtonaction function described below.

XtNhistogramMotion (class XtCHistogramMotion)

Type: XtCallbackList,Default: NULL

The functions on this callback list may be called by theButtonaction function described below.

XtNhistogramKill (class XtCHistogramKill)

Type: XtCallbackList,Default: NULL

Not invoked by the Histogram widget.

HISTOGRAM ACTIONS

Crossing

Invokes the functions on the callback listXtNhistogramCrossing.

Button

This action assigns values to the attributes of theHistogramButtonCallbackRec structure and invokes the callbackfunctions on the XtNhistogramButton (if the event wasButtonPress or ButtonRelease) or XtNhistogramMotion (if theevent was MotionNotify) callback-list with a reference tothe HistogramButtonCallbackRec structure.

The attributes of the HistogramButtonCallbackRec structure are

eventAn "XEvent *" reference to the event which triggered theaction function.

imageIdentical to the resource XtNhistogramImage.

bandIdentical to the resource XtNhistogramBand.

histogramIdentical to the resource XtNhistogramHistogram.

kumulativA reference to an integer array with cumulative histogramvalues.

lengthIdential to the resource XtNhistogramLength.

korhInteger which is set if the displayed histogram iscumulative, unset if it is normal.

x, yTwo integers which represent the coordinates where one ofthe events ButtonPress, ButtonRelease or MotionNotify tookplace. yis 255 minus the actual event verticalcoordinate, so that it represents the height above thebaseline in the Histogram widget.

ChangeMode

This action function changes mode between display ofhistogram and display of cumulative histogram.

HistogramKill

Same as the HistogramKill convenience function described below.

DEFAULT TRANSLATION BINDINGS

<EnterWindow>:         Crossing()
<LeaveWindow>:         Crossing()
<Key>Q:                HistogramKill()
Ctrl <BtnDown>:        ChangeMode()
Ctrl <BtnUp>:          ChangeMode()
<BtnDown>:             Button()
<BtnUp>:               Button()
<Motion>:              Button()

HISTOGRAM CALLBACKS

See the resources XtNhistogramCrossing, XtNhistogramButton,XtNhistogramMotion and XtNhistogramKill.

CONVENIENCE ROUTINES

HistogramRedisplay

void HistogramRedisplay( Widget wid );

Invoke the expose method, with NULL as event and regionarguments.

Draw_all_lines

void Draw_all_lines( Widget wid, int func );

Draw the manipulating lines in the Histogram widget.funcgives the logical drawing function, typicallyGXor (draw) or GXandInverted (erase).

HistogramKill

void HistogramKill ( Widget wid, XEvent *event,
String *params, Cardinal *num_params );

Kill the widget tree starting with the ancestor shell.

HistogramInitLines

void HistogramInitLines( HistogramWidget wid,
int col, int threshold );

Setup to draw a unit ramp or a threshold line (depending onwhether thresholdis set or not) in the Histogram widget,for the primaries given by col(which may be inclusive or ofDoRed, DoGreen and DoBlue). Then draw all three manipulatinglines (one or more of which has now been changed).

HistogramThreshold

void HistogramThreshold( HistogramWidget wid,
int point, int col );

Make treshold manipulating lines for the primaries indicatedby col(which may by inclusive or of DoRed, DoGreen andDoBlue). Use pointas the bin number where the thresholdwill be. Draw all three manipulating lines (of which somemay now be thresholds, some are as before).

HistogramInsertPoint

void HistogramInsertPoint( HistogramWidget wid,
int point, int val, int col );

Insert a point at point(for a broken line) in themanipulating primary given by col.

HistogramMovePoint

void HistogramMovePoint( HistogramWidget wid,
int point, int val, int col );

Move the line breakpoint (in primaries given by col)closestto pointto new location point(if the closest point isnot too far off).

HistogramDeletePoint

void HistogramDeletePoint( HistogramWidget wid,
int point, int val, int col );

Delete line breakpoint closest to pointfor primaries givenby col.Only delete point if it is not too far off point.valis not used.

HistogramInspect

void HistogramInspect( HistogramWidget wid,
XColor *colortab );

Return in colortab(which must be allocated by the caller)a colortable which reflects the manipulating primary linesin the Histogram widget.

HistogramGet

void HistogramGet( HistogramWidget wid,
XColor *tab, int *len );

Return in tabthe entries in the Histogram widgetmanipulating lines which are set (i.e. breakpoints).the flags attribute of a colortable entry is taken fromthe mask attribute of the Histogram widget (inclusive or ofDoRed, DoGreen and DoBlue).

lenreturns the number of cells set in tab(from cellnumber zero to cell number len-1.

HistogramSet

void HistogramSet( HistogramWidget wid,
XColor *tab, int len );

Set the manipulating primary lines from tab.

AUTHOR

Otto Milvang and Svein Bře

DOC

Svein Bře

This document was created byman2html,using the manual pages.

HISTOGRAM

NAME

APPLICATION HEADER FILE

CLASS HEADER FILE

CLASS

CLASS NAME

SUPERCLASS

DESCRIPTION

RESOURCES

HISTOGRAM ACTIONS

DEFAULT TRANSLATION BINDINGS

HISTOGRAM CALLBACKS

CONVENIENCE ROUTINES

AUTHOR

SEE ALSO

DOC

Index