BOOPSI Images - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:17:00Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

← Older revision		Revision as of 19:17, 26 January 2025
Line 41:		Line 41:
	The IM_DRAW method is used to tell the image to render itself. The Intuition function DrawImageState() uses this method. IM_DRAW receives the following parameters:		The IM_DRAW method is used to tell the image to render itself. The Intuition function DrawImageState() uses this method. IM_DRAW receives the following parameters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impDraw		struct impDraw
	{		{
Line 81:		Line 81:
	The following code fragment shows how to use the shadow color for rendering.		The following code fragment shows how to use the shadow color for rendering.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	uint16 *pens = (imp->imp_DrInfo) ? imp->imp_DrInfo->dri_Pens : NULL;		uint16 *pens = (imp->imp_DrInfo) ? imp->imp_DrInfo->dri_Pens : NULL;

Line 94:		Line 94:
	The IM_DRAWFRAME method instructs the image to render itself within the confines of the given rectangle. It receives the following parameters:		The IM_DRAWFRAME method instructs the image to render itself within the confines of the given rectangle. It receives the following parameters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impDraw		struct impDraw
	{		{
Line 124:		Line 124:
	The IM_ERASE method tells an image to erase itself. The Intuition function EraseImage() uses this method. IM_ERASE receives the following parameters:		The IM_ERASE method tells an image to erase itself. The Intuition function EraseImage() uses this method. IM_ERASE receives the following parameters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impErase		struct impErase
	{		{
Line 146:		Line 146:
	parameters:		parameters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impEraseFrame		struct impEraseFrame
	{		{
Line 172:		Line 172:
	The IM_HITFRAME method is used to determine if a point is within an image that is contained within (or scaled to) the given rectangle. This method is intended to test images that were rendered using IM_DRAWFRAME. This method receives the following parameters:		The IM_HITFRAME method is used to determine if a point is within an image that is contained within (or scaled to) the given rectangle. This method is intended to test images that were rendered using IM_DRAWFRAME. This method receives the following parameters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impHitFrame		struct impHitFrame
	{		{
Line 196:		Line 196:
	IM_HITTEST returns true if a point is within the image. The Intuition function PointInImage() uses this method. IM_HITTEST requires the following parameters:		IM_HITTEST returns true if a point is within the image. The Intuition function PointInImage() uses this method. IM_HITTEST requires the following parameters:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impHitTest		struct impHitTest
	{		{
Line 214:		Line 214:
	The IM_FRAMEBOX method returns size information for an image (usually some sort of frame image). The following parameters are associated with the IM_FRAMEBOX method.		The IM_FRAMEBOX method returns size information for an image (usually some sort of frame image). The following parameters are associated with the IM_FRAMEBOX method.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct impFrameBox		struct impFrameBox
	{		{
Line 238:		Line 238:
	The example code initializes and uses a custom imageclass object. Notice that usemyIC.c directly manipulates fields within the Image structure embedded within the BOOPSI imageclass object. This is legal for image classes whose immediate superclass is imageclass (for the LeftEdge, TopEdge, Width, Height, ImageData, PlanePick, and PlaneOnOff Image structure fields only; the other Image structure fields are off limits). Indirect subclasses of imageclass may not alter the values in the embedded Image structure as future direct subclasses of imageclass may need to know about changes to values in the Image structure.		The example code initializes and uses a custom imageclass object. Notice that usemyIC.c directly manipulates fields within the Image structure embedded within the BOOPSI imageclass object. This is legal for image classes whose immediate superclass is imageclass (for the LeftEdge, TopEdge, Width, Height, ImageData, PlanePick, and PlaneOnOff Image structure fields only; the other Image structure fields are off limits). Indirect subclasses of imageclass may not alter the values in the embedded Image structure as future direct subclasses of imageclass may need to know about changes to values in the Image structure.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	/*		/*
	* usemyIC.c		* usemyIC.c
Line 352:		Line 352:
	A custom image can be used in the place of any standard Intuition Image structure. For example, an application can attach an imageclass object to: the GadgetRender and SelectRender fields of a Gadget structure (defined in <intuition/intuition.h>), the ReqImage field of a Requester structure, or even the ItemFill field of the MenuItem structure.		A custom image can be used in the place of any standard Intuition Image structure. For example, an application can attach an imageclass object to: the GadgetRender and SelectRender fields of a Gadget structure (defined in <intuition/intuition.h>), the ReqImage field of a Requester structure, or even the ItemFill field of the MenuItem structure.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	/*		/*
	* Original code written by David N. Junod		* Original code written by David N. Junod

Frédéric Khannouf: /* mytextlabelclass.c */ Removed some useless definitions. Some cleaning and type castings

2024-09-10T12:10:45Z

mytextlabelclass.c: Removed some useless definitions. Some cleaning and type castings

Show changes

Steven Solie: /* mytextlabelclass.c */

2013-04-09T17:10:59Z

mytextlabelclass.c

Show changes

Steven Solie: /* mytextlabelclass.c */

2013-04-08T20:13:55Z

mytextlabelclass.c

← Older revision		Revision as of 20:13, 8 April 2013
Line 398:		Line 398:
	#include <proto/utility.h>		#include <proto/utility.h>

	extern struct ~~Library~~ ~~IntuitionBase, GfxBase, *UtilityBase~~;		extern struct IntuitionIFace *IIntuition;
			extern struct GraphicsIFace *IGraphics;

	/*		/*
Line 404:		Line 405:
	* object is an intuition Image structure.		* object is an intuition Image structure.
	*/		*/
	#define IM(o) ((struct Image *)(o))		#define IM(o) ((struct Image *)(o))

	#define MYCLASSID NULL		#define MYCLASSID NULL
	#define SUPERCLASSID (IMAGECLASS)		#define SUPERCLASSID (IMAGECLASS)

	Class *initmyTextLabelClass(VOID);		Class *initmyTextLabelClass(VOID);
Line 434:		Line 435:

	/* The key that is underlined */		/* The key that is underlined */
	~~UWORD~~ lod_Key;		uint16 lod_Key;

	/* DrawMode */		/* DrawMode */
	~~UBYTE~~ lod_Mode;		uint8 lod_Mode;
	};		};

Line 459:		Line 460:
	ULONG freemyTextLabelClass(Class * cl)		ULONG freemyTextLabelClass(Class * cl)
	{		{

	/* Try to free the public class */		/* Try to free the public class */
	return ((ULONG) IIntuition->FreeClass(cl));		return ((ULONG) IIntuition->FreeClass(cl));
Line 539:		Line 539:
	/* process rest */		/* process rest */
	tstate = tags;		tstate = tags;
	while (tag = NextTagItem(&tstate))		while (tag = IUtility->NextTagItem(&tstate))
	{		{
	tidata = tag->ti_Data;		tidata = tag->ti_Data;
Line 688:		Line 688:
	{		{
	/* Didn't find an '_' sign */		/* Didn't find an '_' sign */
	Text(rp, label, len);		IGraphics->Text(rp, label, len);
	}		}
	return (1L);		return (1L);

Steven Solie: /* usemyIC.c */

2013-04-08T20:10:29Z

usemyIC.c

← Older revision		Revision as of 20:10, 8 April 2013
Line 257:		Line 257:
	#include <libraries/gadtools.h>		#include <libraries/gadtools.h>
	#include <utility/tagitem.h>		#include <utility/tagitem.h>

	#include <clib/macros.h>
	#include <~~clib~~/~~exec_protos~~.h>		#include <proto/exec.h>
	#include <~~clib~~/~~dos_protos~~.h>		#include <proto/dos.h>
	#include <~~clib~~/~~intuition_protos~~.h>		#include <proto/intuition.h>
	#include <~~clib~~/~~graphics_protos~~.h>		#include <proto/graphics.h>
	#include <~~clib~~/~~utility_protos~~.h>		#include <proto/utility.h>
	#include <string.h>		#include <string.h>

	~~extern~~ struct ~~Library~~ ~~SysBase,~~ DOSBase;		struct IntuitionIFace *IIntuition = NULL;
	struct Library IntuitionBase, GfxBase, *UtilityBase;

	Class *initmyTextLabelClass(VOID);		Class *initmyTextLabelClass(VOID);
	ULONG freemyTextLabelClass(Class * cl);		ULONG freemyTextLabelClass(Class * cl);

		⚫	int main()
	VOID
⚫	main(~~VOID~~)
	{		{
	Class *cl;		Class *cl;
	struct Image *im;		struct Image *im;
	struct Window *win;		struct Window *win;
	struct RastPort *rp;
	UWORD top, left, height;

		⚫	struct Library *IntuitionBase = IExec->OpenLibrary("intuition.library", 50);
	/* Make sure we're at least using Version 2.0 */
	if ~~(IntuitionBase~~ = OpenLibrary("~~intuition~~.library", ~~36)~~)		struct Library *GfxBase = IExec->OpenLibrary("graphics.library", 50);
	{
			IIntuition = (struct IntuitionIFace*)IExec->GetInterface(IntuitionBase, "main", 1, NULL);
⚫	~~GfxBase~~ = OpenLibrary("~~graphics~~.library", 36);
			IGraphics = (struct GraphicsIFace*)IExec->GetInterface(GfxBase, "main", 1, NULL);
	UtilityBase = OpenLibrary("utility.library", 36);

			if (IIntuition != NULL && IGraphics != NULL)
			{
	/* Open a window, without system gadgets or IDCMP events */		/* Open a window, without system gadgets or IDCMP events */
	if (win = OpenWindowTags(NULL,		if (win = IIntuition->OpenWindowTags(NULL,
	WA_Left, 10,		WA_Left, 10,
	WA_Top, 10,		WA_Top, 10,
	WA_Width, 320,		WA_Width, 320,
	WA_Height, 100,		WA_Height, 100,
	~~TAG_DONE~~))		TAG_END))
	{		{
	/* Cache the pointer to the RastPort */		/* Cache the pointer to the RastPort */
	rp = win->RPort;		struct RastPort *rp = win->RPort;

	/* Cache the upper-left coordinates of the window */		/* Cache the upper-left coordinates of the window */
	top = win->BorderTop + INTERHEIGHT;		uint16 top = win->BorderTop + INTERHEIGHT;
	left = win->BorderRight + INTERWIDTH;		uint16 left = win->BorderRight + INTERWIDTH;

	/* Cache the height of the font */		/* Cache the height of the font */
	height = rp->TxHeight + INTERHEIGHT;		uint16 height = rp->TxHeight + INTERHEIGHT;

	/* Initialize the custom image class. */		/* Initialize the custom image class. */
Line 308:		Line 306:
	{		{
	/* Create a new image structure, using the given string. */		/* Create a new image structure, using the given string. */
	if (im = NewObject(cl, NULL,		if (im = IIntuition->NewObject(cl, NULL,
	IA_Data, (ULONG) "Line _1",		IA_Data, (ULONG) "Line _1",
	~~TAG_DONE~~))		TAG_END))
	{		{
	/* Paint using the provided text string. */		/* Paint using the provided text string. */
	DrawImageState(rp, im, left, top,		IIntuition->DrawImageState(rp, im, left, top,
	IDS_NORMAL, NULL);		IDS_NORMAL, NULL);

	/* Replace the text string, and paint it. */		/* Replace the text string, and paint it. */
	im->ImageData = (USHORT *) "Line _2";		im->ImageData = (USHORT *) "Line _2";
	DrawImageState(rp, im, left, top + height,		IIntuition->DrawImageState(rp, im, left, top + height,
	IDS_NORMAL, NULL);		IDS_NORMAL, NULL);

	/* Replace the text string, and paint it. */		/* Replace the text string, and paint it. */
	im->ImageData = (USHORT *) "Line _3";		im->ImageData = (USHORT *) "Line _3";
	DrawImageState(rp, im, left, top + (height * 2),		IIntuition->DrawImageState(rp, im, left, top + (height * 2),
	IDS_NORMAL, NULL);		IDS_NORMAL, NULL);

	/* Free the image. */		/* Free the image. */
	DisposeObject(im);		IIntuition->DisposeObject(im);
	}		}

Line 334:		Line 332:
	}		}

	Delay(250);		IDOS->Delay(250);
	CloseWindow(win);		IIntuition->CloseWindow(win);
	}		}

⚫	CloseLibrary(~~UtilityBase~~);
⚫	CloseLibrary(~~GfxBase~~);
	CloseLibrary(IntuitionBase);
	}		}

			IExec->DropInterface((struct Interface*)IGraphics);
			IExec->DropInterface((struct Interface*)IIntuition);
		⚫	IExec->CloseLibrary(GfxBase);
		⚫	IExec->CloseLibrary(IntuitionBase);

			return 0;
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Steven Solie: /* mytextlabelclass.c */

2013-04-08T20:03:52Z

mytextlabelclass.c

← Older revision		Revision as of 20:03, 8 April 2013
Line 346:		Line 346:

	=== mytextlabelclass.c ===		=== mytextlabelclass.c ===

			The image class example code, mytextlabelclass.c, illustrates a complete custom image class. This image class provides an application with textual labels that have a particular character underlined. This is useful for indicating which key controls a gadget (although the example provided only utilizes imageclass objects; there are no gadgets involved).

			A custom image can be used in the place of any standard Intuition Image structure. For example, an application can attach an imageclass object to: the GadgetRender and SelectRender fields of a Gadget structure (defined in <intuition/intuition.h>), the ReqImage field of a Requester structure, or even the ItemFill field of the MenuItem structure.

	<syntaxhighlight>		<syntaxhighlight>

Steven Solie: /* usemyIC.c */

2013-04-08T20:03:05Z

usemyIC.c

← Older revision		Revision as of 20:03, 8 April 2013
Line 236:		Line 236:
	=== usemyIC.c ===		=== usemyIC.c ===

			The example code initializes and uses a custom imageclass object. Notice that usemyIC.c directly manipulates fields within the Image structure embedded within the BOOPSI imageclass object. This is legal for image classes whose immediate superclass is imageclass (for the LeftEdge, TopEdge, Width, Height, ImageData, PlanePick, and PlaneOnOff Image structure fields only; the other Image structure fields are off limits). Indirect subclasses of imageclass may not alter the values in the embedded Image structure as future direct subclasses of imageclass may need to know about changes to values in the Image structure.
	<syntaxhighlighting>

			<syntaxhighlight>
	/*		/*
	* usemyIC.c		* usemyIC.c
Line 341:		Line 343:
	}		}
	}		}
			</syntaxhighlight>
	</syntaxhighlighting>

	=== mytextlabelclass.c ===		=== mytextlabelclass.c ===

Steven Solie: /* mytextlabelclass.c */

2013-04-08T20:01:06Z

mytextlabelclass.c

@@ Line 232: / Line 232: @@
 This method is not supported by the mytextlabelclass example. It passes this message to its superclass which does not support this method either. When the message returns from the superclass, the return value will be zero, indicating to the application that this method is not supported.
-== mytextlabelclass.c ==
+== Examples ==
 <syntaxhighlight>

Steven Solie: /* mytextlabelclass.c */

2013-04-05T22:03:51Z

mytextlabelclass.c

← Older revision		Revision as of 22:03, 5 April 2013
Line 293:		Line 293:
	Class *initmyTextLabelClass(VOID);		Class *initmyTextLabelClass(VOID);
	ULONG freemyTextLabelClass(Class * cl);		ULONG freemyTextLabelClass(Class * cl);
	ULONG ~~__saveds~~ dispatchmyTextLabel(Class * cl, Object * o, Msg msg);		ULONG dispatchmyTextLabel(Class * cl, Object * o, Msg msg);
	ULONG setmyTextLabelAttrs(Class * cl, Object * o, struct opSet * msg);		ULONG setmyTextLabelAttrs(Class * cl, Object * o, struct opSet * msg);
	ULONG getmyTextLabelAttr(Class * cl, Object * o, struct opGet * msg);		ULONG getmyTextLabelAttr(Class * cl, Object * o, struct opGet * msg);

Steven Solie: /* mytextlabelclass.c */

2013-04-05T22:03:17Z

mytextlabelclass.c

Show changes