Name
hw_ChangeRootDisplaySize -- change size of satellite's root display (V5.2)
Synopsis
int error = hw_ChangeRootDisplaySize(APTR handle, int width, int height,
                struct hwTagList *tags);
Function
This function can be used to force a size change of the satellite's root display. Please note that this will not trigger a HWSATOP_RESIZE operation for your satellite's dispatcher. It is assumed that the satellite has already been resized when it calls this function. Calling hw_ChangeRootDisplaySize(), however, will trigger a satellite refresh so your dispatcher will get some drawing events like HWSATOP_BLTBITMAP.

Additionally, you can specify a taglist in the second parameter. The following tags are currently recognized:

HWCRDSTAG_SCALEWIDTH:
You can use this tag to set the desired scale width for the satellite's root display. Normally, this is automatically calculated from the size passed in the width parameter but the automatically calculated size could be a little bit of from your desired size because of floating point inaccuracies. So if you want to enforce a specific scale width, just set it in the iData member of this tag. (V8.0)

HWCRDSTAG_SCALEHEIGHT:
You can use this tag to set the desired scale height for the satellite's root display. Normally, this is automatically calculated from the size passed in the height parameter but the automatically calculated size could be a little bit of from your desired size because of floating point inaccuracies. So if you want to enforce a specific scale height, just set it in the iData member of this tag. (V8.0)

See hw_AttachDisplaySatellite for details.

Designer compatibility
Unsupported

Inputs
handle
satellite handle allocated by hw_AttachDisplaySatellite()
width
desired new width for root display in pixels
height
desired new height for root display in pixels
tags
pointer to a taglist specifying additional options (see above) or NULL
Results
error
error code or 0 on success

Show TOC