[−][src]Struct sciter::graphics::State
A graphics state guard.
Used to automatically restore a previous saved graphics attributes state.
Methods from Deref<Target = Graphics>
pub fn save_state(&mut self) -> Result<State>
[src]
Save the current graphics attributes on top of the internal state stack.
It will be restored automatically.
Example:
use sciter::graphics::{Image, rgb}; let mut image = Image::new((100, 100), false).unwrap(); image.paint(|gfx, size| { let mut gfx = gfx.save_state()?; gfx .line_width(6.0)? .line_color(rgb(0xD4, 0, 0))? .fill_color(rgb(0xD4, 0, 0))? .line((-30., 0.), (83., 0.))? ; Ok(()) }).unwrap();
pub fn flush(&mut self) -> Result<&mut Self>
[src]
Flush all pending graphic operations.
pub fn line(&mut self, start: Pos, end: Pos) -> Result<&mut Self>
[src]
Draw a line from the start
to the end
.
pub fn rectangle(
&mut self,
left_top: Pos,
right_bottom: Pos
) -> Result<&mut Self>
[src]
&mut self,
left_top: Pos,
right_bottom: Pos
) -> Result<&mut Self>
Draw a rectangle.
pub fn round_rect(
&mut self,
left_top: Pos,
right_bottom: Pos,
radius: Dim
) -> Result<&mut Self>
[src]
&mut self,
left_top: Pos,
right_bottom: Pos,
radius: Dim
) -> Result<&mut Self>
Draw a rounded rectangle with the same corners.
pub fn round_rect4(
&mut self,
left_top: Pos,
right_bottom: Pos,
radius: (Dim, Dim, Dim, Dim)
) -> Result<&mut Self>
[src]
&mut self,
left_top: Pos,
right_bottom: Pos,
radius: (Dim, Dim, Dim, Dim)
) -> Result<&mut Self>
Draw a rounded rectangle with different corners.
pub fn ellipse(&mut self, xy: Pos, radii: Pos) -> Result<&mut Self>
[src]
Draw an ellipse.
pub fn circle(&mut self, xy: Pos, radius: Dim) -> Result<&mut Self>
[src]
Draw a circle.
pub fn arc(
&mut self,
xy: Pos,
rxy: Pos,
start: Angle,
sweep: Angle
) -> Result<&mut Self>
[src]
&mut self,
xy: Pos,
rxy: Pos,
start: Angle,
sweep: Angle
) -> Result<&mut Self>
Draw a closed arc.
pub fn star(
&mut self,
xy: Pos,
r1: Dim,
r2: Dim,
start: Angle,
rays: usize
) -> Result<&mut Self>
[src]
&mut self,
xy: Pos,
r1: Dim,
r2: Dim,
start: Angle,
rays: usize
) -> Result<&mut Self>
Draw a star.
pub fn polygon(&mut self, points: &[Pos]) -> Result<&mut Self>
[src]
Draw a closed polygon.
pub fn polyline(&mut self, points: &[Pos]) -> Result<&mut Self>
[src]
Draw a polyline.
pub fn fill_color(&mut self, color: Color) -> Result<&mut Self>
[src]
Set the color for solid fills for subsequent drawings.
pub fn fill_mode(&mut self, is_even: bool) -> Result<&mut Self>
[src]
Set the even/odd rule of solid fills for subsequent drawings.
false
means "fill non zero".
pub fn no_fill(&mut self) -> Result<&mut Self>
[src]
Disables fills for subsequent drawing operations.
pub fn line_color(&mut self, color: Color) -> Result<&mut Self>
[src]
Set the line color for subsequent drawings.
pub fn line_width(&mut self, width: Dim) -> Result<&mut Self>
[src]
Set the line width for subsequent drawings.
pub fn line_cap(&mut self, style: LINE_CAP) -> Result<&mut Self>
[src]
Set the line cap mode (stroke dash ending style) for subsequent drawings.
It determines how the end points of every line are drawn.
There are three possible values for this property and those are: BUTT
, ROUND
and SQUARE
.
By default this property is set to BUTT
.
pub fn line_join(&mut self, style: LINE_JOIN) -> Result<&mut Self>
[src]
Set the line join mode for subsequent drawings.
It determines how two connecting segments (of lines, arcs or curves) with non-zero lengths in a shape are joined together (degenerate segments with zero lengths, whose specified endpoints and control points are exactly at the same position, are skipped).
pub fn no_line(&mut self) -> Result<&mut Self>
[src]
Disable outline drawing.
pub fn line_linear_gradient(
&mut self,
start: Pos,
end: Pos,
c1: Color,
c2: Color
) -> Result<&mut Self>
[src]
&mut self,
start: Pos,
end: Pos,
c1: Color,
c2: Color
) -> Result<&mut Self>
Setup parameters of a linear gradient of lines.
pub fn line_linear_gradients(
&mut self,
start: Pos,
end: Pos,
colors: &[(Color, Dim)]
) -> Result<&mut Self>
[src]
&mut self,
start: Pos,
end: Pos,
colors: &[(Color, Dim)]
) -> Result<&mut Self>
Setup parameters of a linear gradient of lines using multiple colors and color stop positions (0.0 ... 1.0)
.
pub fn fill_linear_gradient(
&mut self,
c1: Color,
c2: Color,
start: Pos,
end: Pos
) -> Result<&mut Self>
[src]
&mut self,
c1: Color,
c2: Color,
start: Pos,
end: Pos
) -> Result<&mut Self>
Setup parameters of linear gradient fills.
pub fn fill_linear_gradients(
&mut self,
colors: &[(Color, Dim)],
start: Pos,
end: Pos
) -> Result<&mut Self>
[src]
&mut self,
colors: &[(Color, Dim)],
start: Pos,
end: Pos
) -> Result<&mut Self>
Setup parameters of linear gradient fills using multiple colors and color stop positions (0.0 ... 1.0)
.
pub fn line_radial_gradient(
&mut self,
point: Pos,
radii: (Dim, Dim),
c1: Color,
c2: Color
) -> Result<&mut Self>
[src]
&mut self,
point: Pos,
radii: (Dim, Dim),
c1: Color,
c2: Color
) -> Result<&mut Self>
Setup parameters of a radial gradient of lines.
pub fn line_radial_gradients(
&mut self,
point: Pos,
radii: (Dim, Dim),
colors: &[(Color, Dim)]
) -> Result<&mut Self>
[src]
&mut self,
point: Pos,
radii: (Dim, Dim),
colors: &[(Color, Dim)]
) -> Result<&mut Self>
Setup parameters of a radial gradient of lines using multiple colors and color stop positions (0.0 ... 1.0)
.
pub fn fill_radial_gradient(
&mut self,
c1: Color,
c2: Color,
point: Pos,
radii: (Dim, Dim)
) -> Result<&mut Self>
[src]
&mut self,
c1: Color,
c2: Color,
point: Pos,
radii: (Dim, Dim)
) -> Result<&mut Self>
Setup parameters of radial gradient of fills.
pub fn fill_radial_gradients(
&mut self,
colors: &[(Color, Dim)],
point: Pos,
radii: (Dim, Dim)
) -> Result<&mut Self>
[src]
&mut self,
colors: &[(Color, Dim)],
point: Pos,
radii: (Dim, Dim)
) -> Result<&mut Self>
Setup parameters of radial gradient of fills using multiple colors and color stop positions (0.0 ... 1.0)
.
pub fn rotate(&mut self, radians: Angle) -> Result<&mut Self>
[src]
Rotate coordinate system on radians
angle.
pub fn rotate_around(
&mut self,
radians: Angle,
center: Pos
) -> Result<&mut Self>
[src]
&mut self,
radians: Angle,
center: Pos
) -> Result<&mut Self>
Rotate coordinate system on radians
angle around the center
.
pub fn translate(&mut self, to_xy: Pos) -> Result<&mut Self>
[src]
Move origin of coordinate system to the (to_x, to_y)
point.
pub fn scale(&mut self, sc_xy: Pos) -> Result<&mut Self>
[src]
Scale coordinate system.
(sc_x, sc_y)
are the scale factors in the horizontal and vertical directions respectively.
Both parameters must be positive numbers.
Values smaller than 1.0
reduce the unit size and values larger than 1.0
increase the unit size.
pub fn skew(&mut self, sh_xy: Pos) -> Result<&mut Self>
[src]
Setup a skewing (shearing) transformation.
pub fn transform(
&mut self,
scale_by: Pos,
skew_by: Pos,
move_to: Pos
) -> Result<&mut Self>
[src]
&mut self,
scale_by: Pos,
skew_by: Pos,
move_to: Pos
) -> Result<&mut Self>
Multiply the current transformation with the matrix described by the arguments.
It allows to scale, rotate, move and skew the context as described by:
scale_x skew_y move_x
[ skew_x scale_y move_y ]
0 0 1
where
scale_x
,scale_y
: horizontal and vertical scaling,skew_x
,skew_y
: horizontal and vertical shearing (skewing),move_x
,move_y
: horizontal and vertical moving.
pub fn transform_matrix(
&mut self,
m11: Dim,
m12: Dim,
m21: Dim,
m22: Dim,
dx: Dim,
dy: Dim
) -> Result<&mut Self>
[src]
&mut self,
m11: Dim,
m12: Dim,
m21: Dim,
m22: Dim,
dx: Dim,
dy: Dim
) -> Result<&mut Self>
Multiply the current transformation with the matrix described by the arguments.
It allows to scale, rotate, move and skew the context as described by:
m11 m21 dx
[ m12 m22 dy ]
0 0 1
m11
(scale_x
): horizontal scalingm12
(skew_x
): horizontal skewingm21
(skew_y
): vertical skewingm22
(scale_y
): vertical scalingdx
(move_x
): horizontal movingdy
(move_y
): vertical moving
pub fn world_to_screen(&self, xy: Pos) -> Result<Pos>
[src]
Translate coordinates.
Translates coordinates from a coordinate system defined by rotate()
, scale()
, translate()
and/or skew()
to the screen coordinate system.
pub fn world_to_screen1(&self, length: Dim) -> Result<Dim>
[src]
Translate coordinates.
Translates coordinates from a coordinate system defined by rotate()
, scale()
, translate()
and/or skew()
to the screen coordinate system.
pub fn screen_to_world(&self, xy: Pos) -> Result<Pos>
[src]
Translate coordinates.
Translates coordinates from screen coordinate system to the one defined by rotate()
, scale()
, translate()
and/or skew()
.
pub fn screen_to_world1(&self, length: Dim) -> Result<Dim>
[src]
Translate coordinates.
Translates coordinates from screen coordinate system to the one defined by rotate()
, scale()
, translate()
and/or skew()
.
pub fn push_clip_box(
&mut self,
left_top: Pos,
right_bottom: Pos,
opacity: Option<f32>
) -> Result<&mut Self>
[src]
&mut self,
left_top: Pos,
right_bottom: Pos,
opacity: Option<f32>
) -> Result<&mut Self>
Push a clip layer defined by the specified rectangle bounds.
pub fn push_clip_path(
&mut self,
path: &Path,
opacity: Option<f32>
) -> Result<&mut Self>
[src]
&mut self,
path: &Path,
opacity: Option<f32>
) -> Result<&mut Self>
Push a clip layer defined by the specified path
bounds.
pub fn pop_clip(&mut self) -> Result<&mut Self>
[src]
Pop a clip layer set by previous push_clip_box()
or push_clip_path()
calls.
pub fn draw_text(
&mut self,
text: &Text,
pos: Pos,
point_of: u32
) -> Result<&mut Self>
[src]
&mut self,
text: &Text,
pos: Pos,
point_of: u32
) -> Result<&mut Self>
Renders a text layout object at the position (x,y)
.
point_of
: number in the range 1..9
,
defines what part of text layout corresponds to point (x,y)
.
For meaning of numbers see the numeric pad on keyboard.
pub fn draw_path(&mut self, path: &Path, mode: DRAW_PATH) -> Result<&mut Self>
[src]
Draw the path object using current fill and stroke brushes.
pub fn draw_image(&mut self, image: &Image, pos: Pos) -> Result<&mut Self>
[src]
Draw the whole image onto the graphics surface.
With the current transformation applied (scale, rotation).
Performance: expensive.
pub fn draw_image_part(
&mut self,
image: &Image,
dst_pos: Pos,
dst_size: Size,
src_pos: POINT,
src_size: SIZE
) -> Result<&mut Self>
[src]
&mut self,
image: &Image,
dst_pos: Pos,
dst_size: Size,
src_pos: POINT,
src_size: SIZE
) -> Result<&mut Self>
Draw a part of the image onto the graphics surface.
With the current transformation applied (scale, rotation).
Performance: expensive.
pub fn blend_image(
&mut self,
image: &Image,
dst_pos: Pos,
opacity: f32
) -> Result<&mut Self>
[src]
&mut self,
image: &Image,
dst_pos: Pos,
opacity: f32
) -> Result<&mut Self>
Blend the image with the graphics surface.
No affine transformations.
Performance: less expensive.
pub fn blend_image_part(
&mut self,
image: &Image,
dst_pos: Pos,
opacity: f32,
src_pos: POINT,
src_size: SIZE
) -> Result<&mut Self>
[src]
&mut self,
image: &Image,
dst_pos: Pos,
opacity: f32,
src_pos: POINT,
src_size: SIZE
) -> Result<&mut Self>
Blend a part of the image with the graphics surface.
No affine transformations.
Performance: less expensive.
Trait Implementations
impl<'a> Deref for State<'a>
[src]
Dereference to Graphics
.
impl<'a> DerefMut for State<'a>
[src]
Dereference to Graphics
.
impl<'a> Drop for State<'a>
[src]
Restore graphics state.
Auto Trait Implementations
impl<'a> RefUnwindSafe for State<'a>
impl<'a> !Send for State<'a>
impl<'a> !Sync for State<'a>
impl<'a> Unpin for State<'a>
impl<'a> !UnwindSafe for State<'a>
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,