GArc

Class

Index

Class GArc

GObject
  GFillableObject
      GArc

The GArc class is a graphical object whose appearance consists of an arc. The interpretation of the parameters used in the GArc constructor are illustrated in

If unfilled, the arc is simply a portion of the circumference of an ellipse; if filled, the arc is a pie-shaped wedge connected to the center of the figure.

Constructor Summary
`GArc(width, height, start, sweep)` Creates a new `GArc` object consisting of an elliptical arc located at the point (0, 0).
`GArc(x, y, width, height, start, sweep)` Creates a new `GArc` object consisting of an elliptical arc inscribed in the rectangle with the specified bounds.

Method Summary
`get_end_point()` Returns the point at which the arc ends.
`get_frame_rectangle()` Returns the bounds of the `GRectangle` in which this arc is inscribed.
`get_start_angle()` Returns the starting angle for this `GArc` object.
`get_start_point()` Returns the point at which the arc starts.
`get_sweep_angle()` Returns the sweep angle for this `GArc` object.
`set_start_angle(theta)` Sets the starting angle for this `GArc` object.
`set_sweep_angle(sweep)` Sets the sweep angle for this `GArc` object.

Inherited Method Summary
`contains(x, y)` Checks to see whether a point is inside the object.
`get_bounds()` Returns the bounding box for this object.
`get_color()` Returns the color used to display this object.
`get_fill_color()` Returns the color used to display the filled region of this object.
`get_height()` Returns the height of this object, which is defined to be the height of the bounding box.
`get_location()` Returns the location of this object as a `GPoint`.
`get_size()` Returns the size of the bounding box for this object.
`get_width()` Returns the width of this object, which is defined to be the width of the bounding box.
`get_x()` Returns the x-coordinate of the object.
`get_y()` Returns the y-coordinate of the object.
`is_visible()` Checks to see whether this object is visible.
`is_filled()` Returns whether this object is filled.
`move(dx, dy)` Moves the object on the screen using the displacements `dx` and `dy`.
`move_polar(r, theta)` Moves the object using displacements given in polar coordinates.
`scale(sf)` Scales the object on the screen by the scale factor `sf`, which applies in both dimensions.
`send_backward()` Moves this object one step toward the back in the z dimension.
`send_forward()` Moves this object one step toward the front in the z dimension.
`send_to_back()` Moves this object to the back of the display in the z dimension.
`send_to_front()` Moves this object to the front of the display in the z dimension.
`set_color(color)` Sets the color used to display this object.
`set_fill_color(color)` Sets the color used to display the filled region of this object.
`set_filled(flag)` Sets whether this object is filled.
`set_location(x, y)` Sets the location of this object to the point (`x`, `y`).
`set_visible(flag)` Sets whether this object is visible.

Constructor Detail

`GArc(width, height, start, sweep)`

Creates a new GArc object consisting of an elliptical arc located at the point (0, 0). For complete descriptions of the other parameters, see the entry for the GArc constructor that includes explicit x and y parameters.

Usage: garc = GArc(width, height, start, sweep)

Parameters:

`width`	The width of the rectangle in which the arc is inscribed
`height`	The height of the rectangle in which the arc is inscribed
`start`	The angle at which the arc begins measured in degrees counterclockwise from the +x axis
`sweep`	The extent of the arc, measured in degrees counterclockwise

`GArc(x, y, width, height, start, sweep)`

Creates a new GArc object consisting of an elliptical arc inscribed in the rectangle with the specified bounds. The start parameter indicates the angle at which the arc begins and is measured in degrees counterclockwise from the +x axis. Thus, a start angle of 0 indicates an arc that begins along the line running eastward from the center (the 3:00 o’clock position), a start angle of 135 begins along the line running northwest, and a start angle of -90 begins along the line running south (the 6:00 o’clock position). The sweep parameter indicates the extent of the arc and is also measured in degrees counterclockwise. A sweep angle of 90 defines a quarter circle extending counterclockwise from the start angle, and a sweep angle of -180 defines a semicircle extending clockwise.

Usage: garc = GArc(x, y, width, height, start, sweep)

Parameters:

`x`	The x-coordinate for the rectangle in which the arc is inscribed
`y`	The y-coordinate for the rectangle in which the arc is inscribed
`width`	The width of the rectangle in which the arc is inscribed
`height`	The height of the rectangle in which the arc is inscribed
`start`	The angle at which the arc begins measured in degrees counterclockwise from the +x axis
`sweep`	The extent of the arc, measured in degrees counterclockwise

Method Detail

`get_end_point()`

Returns the point at which the arc ends.

Usage:	`pt = garc.get_end_point()`
Returns:	The point at which the arc ends

`get_frame_rectangle()`

Returns the bounds of the GRectangle in which this arc is inscribed. Note that this is usually different from the bounding box returned by get_bounds, which returns the bounding box in which the displayed portion of the arc is contained.

Usage:	`bounds = garc.get_frame_rectangle()`
Returns:	The `GRectangle` in which this arc is inscribed

`get_start_angle()`

Returns the starting angle for this GArc object.

Usage:	`start = garc.get_start_angle()`
Returns:	The starting angle for this arc

`get_start_point()`

Returns the point at which the arc starts.

Usage:	`pt = garc.get_start_point()`
Returns:	The point at which the arc starts

`get_sweep_angle()`

Returns the sweep angle for this GArc object.

Usage:	`sweep = garc.get_sweep_angle()`
Returns:	The sweep angle for this arc

`set_frame_rectangle(x, y, width, height)`

Changes the arc bounds to the specified values.

Usage: garc.set_frame_rectangle(x, y, width, height)

Parameters:

`x`	The x-coordinate for the rectangle in which the arc is inscribed
`y`	The y-coordinate for the rectangle in which the arc is inscribed
`width`	The width of the rectangle in which the arc is inscribed
`height`	The height of the rectangle in which the arc is inscribed

`set_start_angle(theta)`

Sets the starting angle for this GArc object.

Usage: garc.set_start_angle(start)

Parameter:

start The new starting angle

`set_sweep_angle(sweep)`

Sets the sweep angle for this GArc object.

Usage: garc.set_sweep_angle(sweep)

Parameter:

sweep The new sweep angle

Overview

Class

Index