A drawing surface producing a Scalable Vector Graphics (SVG) file. More...

#include <Fl_SVG_File_Surface.H>

Inheritance diagram for Fl_SVG_File_Surface:

Public Member Functions
int	close ()
	Closes with function fclose() the FILE pointer where SVG data is output. More...

FILE *	file ()
	Returns the underlying FILE pointer.

	Fl_SVG_File_Surface (int width, int height, FILE *svg)
	Constructor of the SVG drawing surface. More...

virtual void	origin (int x, int y)
	Sets the position of the origin of graphics in the drawable part of the drawing surface. More...

virtual int	printable_rect (int w, int h)
	Computes the width and height of the drawable area of the drawing surface. More...

virtual void	translate (int x, int y)
	Translates the current graphics origin accounting for the current rotation. More...

virtual void	untranslate ()
	Undoes the effect of a previous translate() call.

	~Fl_SVG_File_Surface ()
	Destructor. More...

Public Member Functions inherited from Fl_Widget_Surface
void	draw (Fl_Widget *widget, int delta_x=0, int delta_y=0)
	Draws the widget on the drawing surface. More...

virtual void	draw_decorated_window (Fl_Window *win, int x_offset=0, int y_offset=0)
	Draws a window with its title bar and frame if any. More...

virtual void	origin (int x, int y)
	Computes the coordinates of the current origin of graphics functions. More...

void	print_window_part (Fl_Window *win, int x, int y, int w, int h, int delta_x=0, int delta_y=0)
	Draws a rectangular part of an on-screen window. More...

Public Member Functions inherited from Fl_Surface_Device
Fl_Graphics_Driver *	driver ()
	Returns the graphics driver of this drawing surface. More...

virtual bool	is_current ()
	Is this surface the current drawing surface?

virtual void	set_current (void)
	Make this surface the current drawing surface. More...

virtual	~Fl_Surface_Device ()
	The destructor. More...

Additional Inherited Members
Static Public Member Functions inherited from Fl_Surface_Device
static Fl_Surface_Device *	pop_current ()
	Removes the top element from the current drawing surface stack, and makes the new top element current. More...

static void	push_current (Fl_Surface_Device *new_current)
	Pushes `new_current` on top of the stack of current drawing surfaces, and makes it current. More...

static Fl_Surface_Device *	surface ()
	The current drawing surface. More...

Protected Member Functions inherited from Fl_Widget_Surface
	Fl_Widget_Surface (Fl_Graphics_Driver *d)
	The constructor. More...

Protected Member Functions inherited from Fl_Surface_Device
void	driver (Fl_Graphics_Driver *graphics_driver)
	Sets the graphics driver of this drawing surface. More...

virtual void	end_current ()

	Fl_Surface_Device (Fl_Graphics_Driver *graphics_driver)
	Constructor that sets the graphics driver to use for the created surface. More...

Protected Attributes inherited from Fl_Widget_Surface
int	x_offset
	horizontal offset to the origin of graphics coordinates

int	y_offset
	vertical offset to the origin of graphics coordinates

Detailed Description

A drawing surface producing a Scalable Vector Graphics (SVG) file.

This drawing surface allows to store any FLTK graphics in vectorial form in a "Scalable Vector Graphics" file.
Usage example:

Fl_Window *win = ...// Window to draw to a .svg file
int ww = win->decorated_w();
int wh = win->decorated_h();
FILE *svg = fl_fopen("/path/to/mywindow.svg", "w");
if (svg) {
  Fl_SVG_File_Surface *surface = new Fl_SVG_File_Surface(ww, wh, svg);
  Fl_Surface_Device::push_current(surface);
  fl_color(FL_WHITE);
  fl_rectf(0, 0, ww, wh);
  surface->draw_decorated_window(win);
  Fl_Surface_Device::pop_current();
  delete surface; // the .svg file is not complete until the destructor was run
  fclose(svg);
}

Note: FLTK uses the PNG and JPEG libraries to encode images to the SVG format. For this reason, class Fl_SVG_File_Surface is placed in the fltk_images library. If JPEG is not available at application build time, PNG is enough (but produces a quite larger output). If PNG isn't available either, images don't appear in the SVG output.

Constructor & Destructor Documentation

◆ Fl_SVG_File_Surface()

Fl_SVG_File_Surface::Fl_SVG_File_Surface	(	int	width,
		int	height,
		FILE *	svg
	)

Constructor of the SVG drawing surface.

Parameters

width,height	Width and height of the graphics area in FLTK drawing units
svg	A writable FILE pointer where the SVG data are to be sent. The resulting SVG data are not complete until after destruction of the Fl_SVG_File_Surface object or after calling close().

◆ ~Fl_SVG_File_Surface()

Fl_SVG_File_Surface::~Fl_SVG_File_Surface ( )

Destructor.

The underlying FILE pointer remains open after destruction of the Fl_SVG_File_Surface object unless close() was called.

Member Function Documentation

◆ close()

int Fl_SVG_File_Surface::close ( )

Closes with function fclose() the FILE pointer where SVG data is output.

The only operation possible after this on the Fl_SVG_File_Surface object is its destruction.

Returns: The value returned by fclose().

◆ origin()

virtual void Fl_SVG_File_Surface::origin	(	int	x,
		int	y
	)

virtual

Sets the position of the origin of graphics in the drawable part of the drawing surface.

Arguments should be expressed relatively to the result of a previous printable_rect() call. That is, printable_rect(&w, &h); origin(w/2, 0); sets the graphics origin at the top center of the drawable area. Successive origin() calls don't combine their effects. Origin() calls are not affected by rotate() calls (for classes derived from Fl_Paged_Device).

Parameters

[in] x,y Horizontal and vertical positions in the drawing surface of the desired origin of graphics.

Reimplemented from Fl_Widget_Surface.

◆ printable_rect()

virtual int Fl_SVG_File_Surface::printable_rect	(	int *	w,
		int *	h
	)

virtual

Computes the width and height of the drawable area of the drawing surface.

Values are in the same unit as that used by FLTK drawing functions and are unchanged by calls to origin(). If the object is derived from class Fl_Paged_Device, values account for the user-selected paper type and print orientation and are changed by scale() calls.

Returns: 0 if OK, non-zero if any error

Reimplemented from Fl_Widget_Surface.

◆ translate()

virtual void Fl_SVG_File_Surface::translate	(	int	x,
		int	y
	)

virtual

Translates the current graphics origin accounting for the current rotation.

Each translate() call must be matched by an untranslate() call. Successive translate() calls add up their effects.

Reimplemented from Fl_Widget_Surface.

The documentation for this class was generated from the following file:

Fl_SVG_File_Surface.H

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Fl_SVG_File_Surface()

◆ ~Fl_SVG_File_Surface()

Member Function Documentation

◆ close()

◆ origin()

◆ printable_rect()

◆ translate()