Intuition Images, Line Drawing and Text - Revision history

Steven Solie: /* Displaying Images, Borders and IntuiText */

2015-11-06T19:25:07Z

Displaying Images, Borders and IntuiText

← Older revision		Revision as of 19:25, 6 November 2015
Line 25:		Line 25:
	Images, Borders and IntuiText objects may be directly or indirectly rendered into the display by the application. The application can draw these objects directly into windows or screens by using one of the functions DrawImage(), DrawBorder() or PrintIText(). The application supplies the appropriate pointer to a Border, Image or IntuiText structure as an argument to the function, as well as position information and a pointer to the correct RastPort. These rendering functions are discussed in more detail below.		Images, Borders and IntuiText objects may be directly or indirectly rendered into the display by the application. The application can draw these objects directly into windows or screens by using one of the functions DrawImage(), DrawBorder() or PrintIText(). The application supplies the appropriate pointer to a Border, Image or IntuiText structure as an argument to the function, as well as position information and a pointer to the correct RastPort. These rendering functions are discussed in more detail below.

	The application can also draw these objects indirectly by attaching them to a menu, gadget or requester. As Intuition places these elements on the display, it also renders the associated graphics. The Requester, Gadget, and MenuItem structures contain one or more fields reserved for rendering information. See the specific ~~chapters~~ on these items for information on attaching graphical objects to them.		The application can also draw these objects indirectly by attaching them to a menu, gadget or requester. As Intuition places these elements on the display, it also renders the associated graphics. The Requester, Gadget, and MenuItem structures contain one or more fields reserved for rendering information. See the specific articles on these items for information on attaching graphical objects to them.

	=== Positioning Graphic Objects ===		=== Positioning Graphic Objects ===

Steven Solie: /* Intuition Images, Line Drawing and Text */

2015-11-06T19:24:44Z

Intuition Images, Line Drawing and Text

← Older revision		Revision as of 19:24, 6 November 2015
Line 3:		Line 3:
	Intuition supports two general approaches to creating images, lines, and text in displays: through Intuition library calls and through graphics library calls.		Intuition supports two general approaches to creating images, lines, and text in displays: through Intuition library calls and through graphics library calls.

	This ~~chapter~~ explains the use of Intuition structures and functions for creating display imagery. The Intuition graphical functions provide a high level interface to the graphics library, giving the application quick and easy rendering capabilities. As with any high level calls, some power and flexibility is sacrificed in order to provide a simple interface.		This article explains the use of Intuition structures and functions for creating display imagery. The Intuition graphical functions provide a high level interface to the graphics library, giving the application quick and easy rendering capabilities. As with any high level calls, some power and flexibility is sacrificed in order to provide a simple interface.

	For more flexibility and control over the graphics, the application can directly call functions in the graphics library as discussed in ~~the~~ ~~“Graphics Primitives” chapter~~. Intuition also has additional features for defining custom graphic objects. See ~~the “BOOPSI” chapter~~ for more information on these objects.		For more flexibility and control over the graphics, the application can directly call functions in the graphics library as discussed in [[Graphics Primitives]]. Intuition also has additional features for defining custom graphic objects. See [[BOOPSI_-_Object_Oriented_Intuition\|BOOPSI]] for more information on these objects.

	== Intuition Graphic Objects ==		== Intuition Graphic Objects ==

Steven Solie: /* Intuition Graphic Objects */

2014-04-25T21:10:14Z

Intuition Graphic Objects

← Older revision		Revision as of 21:10, 25 April 2014
Line 36:		Line 36:

	Each object also has an internal, relative component that is added to the external component described above to determine the final position of the object. This allows the application to reuse a graphical object and have it appear relative to each object to which it is attached. For example, if the application has numerous gadgets of the same size, it can use a single Border structure to draw lines around all the gadgets. When the gadgets are drawn, the base position of the lines will be taken from each specific gadget in turn.		Each object also has an internal, relative component that is added to the external component described above to determine the final position of the object. This allows the application to reuse a graphical object and have it appear relative to each object to which it is attached. For example, if the application has numerous gadgets of the same size, it can use a single Border structure to draw lines around all the gadgets. When the gadgets are drawn, the base position of the lines will be taken from each specific gadget in turn.

			=== More Information ===

			For more information on each Intuition graphic object see:
			* [[Intuition Images\|Images]]
			* [[Intuition Borders\|Borders]]
			* [[Intuition Text\|Text]]

	== Function Reference ==		== Function Reference ==

Steven Solie: /* Creating Text */

2014-04-25T21:07:13Z

Creating Text

Show changes

Steven Solie: /* Creating Borders */

2014-04-25T21:03:25Z

Creating Borders

Show changes

Steven Solie: /* Creating Images */

2014-04-25T21:01:40Z

Creating Images

Show changes

Steven Solie at 20:57, 25 April 2014

2014-04-25T20:57:18Z

← Older revision		Revision as of 20:57, 25 April 2014
Line 1:		Line 1:
	{{CodeReview}}
	== Intuition Images, Line Drawing and Text ==		== Intuition Images, Line Drawing and Text ==

Steven Solie: /* IntuiText Example */

2014-04-25T20:56:49Z

IntuiText Example

Show changes

Steven Solie: /* Determining Text Length */

2014-04-25T20:47:28Z

Determining Text Length

← Older revision		Revision as of 20:47, 25 April 2014
Line 749:		Line 749:
	To determine the pixel length of a given IntuiText string, call the IntuiTextLength() function.		To determine the pixel length of a given IntuiText string, call the IntuiTextLength() function.

			<syntaxhighlight>
	<pre>
	LONG IntuiTextLength( struct IntuiText *iText );		LONG IntuiTextLength( struct IntuiText *iText );
			</syntaxhighlight>
	</pre>

	Set the iText argument to point to the IntuiText structure whose length is to be found. This function will return the length of the iText text string in pixels. Note that if the ITextFont field of the given IntuiText is set to NULL, or Intuition cannot access the specified font, then GfxBase->DefaultFont will be used in determining the length of the text. This may not be the same as the RastPort font with which the text would be printed.		Set the iText argument to point to the IntuiText structure whose length is to be found. This function will return the length of the iText text string in pixels. Note that if the ITextFont field of the given IntuiText is set to NULL, or Intuition cannot access the specified font, then GfxBase->DefaultFont will be used in determining the length of the text. This may not be the same as the RastPort font with which the text would be printed.

Steven Solie: /* Directly Drawing the IntuiText */

2014-04-25T20:47:01Z

Directly Drawing the IntuiText

← Older revision		Revision as of 20:47, 25 April 2014
Line 732:		Line 732:
	Use the PrintIText() call to directly draw the text into the target RastPort of a window or screen.		Use the PrintIText() call to directly draw the text into the target RastPort of a window or screen.

			<syntaxhighlight>
	<pre>
	VOID PrintIText( struct RastPort rp, struct IntuiText iText,		VOID PrintIText( struct RastPort rp, struct IntuiText iText,
	LONG left, LONG top );		LONG left, LONG top );
			</syntaxhighlight>
	</pre>

	The rp argument is a pointer to the RastPort into which the text should be drawn. This RastPort can come from a Window or Screen structure.		The rp argument is a pointer to the RastPort into which the text should be drawn. This RastPort can come from a Window or Screen structure.