This class uses Qt libraries, to create frames with "Text", and return openshot::Frame objects. More...

#include <QtTextReader.h>

Inheritance diagram for openshot::QtTextReader:

Collaboration diagram for openshot::QtTextReader:

Public Member Functions
void	Close () override
	Close Reader. More...

CacheBase *	GetCache () override
	Get the cache object used by this reader (always returns NULL for this object) More...

std::shared_ptr< openshot::Frame >	GetFrame (int64_t requested_frame) override

bool	IsOpen () override
	Determine if reader is open or closed. More...

std::string	Json () const override
	Generate JSON string of this object. More...

Json::Value	JsonValue () const override
	Generate Json::Value for this object. More...

std::string	Name () override
	Return the type name of the class. More...

void	Open () override
	Open Reader - which is called by the constructor automatically. More...

	QtTextReader ()
	Default constructor (blank text) More...

	QtTextReader (int width, int height, int x_offset, int y_offset, GravityType gravity, std::string text, QFont font, std::string text_color, std::string background_color)
	Constructor for QtTextReader with all parameters. More...

void	SetJson (const std::string value) override
	Load JSON string into this object. More...

void	SetJsonValue (const Json::Value root) override
	Load Json::Value into this object. More...

void	SetTextBackgroundColor (std::string color)

Public Member Functions inherited from openshot::ReaderBase
void	DisplayInfo (std::ostream *out=&std::cout)
	Display file information in the standard output stream (stdout) More...

virtual bool	HardwareDecodeSuccessful () const

bool	HasMaxDecodeSize () const
	Return true when a maximum decoded frame size is active. More...

int	MaxDecodeHeight () const
	Return the current maximum decoded frame height (0 when unlimited). More...

int	MaxDecodeWidth () const
	Return the current maximum decoded frame width (0 when unlimited). More...

openshot::ClipBase *	ParentClip ()
	Parent clip object of this reader (which can be unparented and NULL) More...

void	ParentClip (openshot::ClipBase *new_clip)
	Set parent clip object of this reader. More...

	ReaderBase ()
	Constructor for the base reader, where many things are initialized. More...

void	SetMaxDecodeSize (int width, int height)
	Set an optional maximum decoded frame size. Use 0,0 to disable the limit. More...

virtual	~ReaderBase ()=default

Additional Inherited Members
Public Attributes inherited from openshot::ReaderBase
openshot::ReaderInfo	info
	Information about the current media file. More...

Protected Attributes inherited from openshot::ReaderBase
openshot::ClipBase *	clip
	Pointer to the parent clip instance (if any) More...

std::recursive_mutex	getFrameMutex
	Mutex for multiple threads. More...

int	max_decode_height
	Optional maximum decoded frame height (0 disables the limit) More...

int	max_decode_width
	Optional maximum decoded frame width (0 disables the limit) More...

Detailed Description

This class uses Qt libraries, to create frames with "Text", and return openshot::Frame objects.

All system fonts are supported, including many different font properties, such as size, color, alignment, padding, etc...

// Any application using this class must instantiate either QGuiApplication or QApplication
QApplication a(argc, argv);
 
// Create a reader to generate an openshot::Frame containing text
QtTextReader r(720, // width
             480, // height
             5, // x_offset
             5, // y_offset
             GRAVITY_CENTER, // gravity
             "Check out this Text!", // text
             "Arial", // font
             15.0, // font size
             "#fff000", // text_color
             "#000000" // background_color
             );
r.Open(); // Open the reader
 
// Get frame number 1 from the video (in fact, any frame # you request will return the same frame)
std::shared_ptr<Frame> f = r.GetFrame(1);
 
// Now that we have an openshot::Frame object, lets have some fun!
f->Display(); // Display the frame on the screen
 
// Close the reader
r.Close();

Definition at line 69 of file QtTextReader.h.

Constructor & Destructor Documentation

◆ QtTextReader() [1/2]

QtTextReader::QtTextReader ( )

Default constructor (blank text)

Definition at line 26 of file QtTextReader.cpp.

◆ QtTextReader() [2/2]

QtTextReader::QtTextReader	(	int	width,
		int	height,
		int	x_offset,
		int	y_offset,
		GravityType	gravity,
		std::string	text,
		QFont	font,
		std::string	text_color,
		std::string	background_color
	)

Constructor for QtTextReader with all parameters.

Parameters

width	The width of the requested openshot::Frame (not the size of the text)
height	The height of the requested openshot::Frame (not the size of the text)
x_offset	The number of pixels to offset the text on the X axis (horizontal)
y_offset	The number of pixels to offset the text on the Y axis (vertical)
gravity	The alignment / gravity of the text
text	The text you want to generate / display
font	The font of the text
text_color	The color of the text (valid values are a color string in #RRGGBB or #AARRGGBB notation or a CSS color name)
background_color	The background color of the frame image (valid values are a color string in #RRGGBB or #AARRGGBB notation, a CSS color name, or 'transparent')

Definition at line 33 of file QtTextReader.cpp.

Member Function Documentation

◆ Close()

void QtTextReader::Close ( )

overridevirtual

Close Reader.

Implements openshot::ReaderBase.

Definition at line 147 of file QtTextReader.cpp.

Referenced by QtTextReader(), SetJsonValue(), and SetTextBackgroundColor().

◆ GetCache()

CacheBase* openshot::QtTextReader::GetCache ( )

inlineoverridevirtual

Get the cache object used by this reader (always returns NULL for this object)

Implements openshot::ReaderBase.

Definition at line 110 of file QtTextReader.h.

◆ GetFrame()

std::shared_ptr< Frame > QtTextReader::GetFrame ( int64_t requested_frame )

overridevirtual

Get an openshot::Frame object for a specific frame number of this reader. All numbers return the same Frame, since they all share the same image data.

Returns: The requested frame (containing the image)

Parameters

requested_frame The frame number that is requested.

Implements openshot::ReaderBase.

Definition at line 164 of file QtTextReader.cpp.

◆ IsOpen()

bool openshot::QtTextReader::IsOpen ( )

inlineoverridevirtual

Determine if reader is open or closed.

Implements openshot::ReaderBase.

Definition at line 120 of file QtTextReader.h.

◆ Json()

std::string QtTextReader::Json ( ) const

overridevirtual

Generate JSON string of this object.

Implements openshot::ReaderBase.

Definition at line 193 of file QtTextReader.cpp.

◆ JsonValue()

Json::Value QtTextReader::JsonValue ( ) const

overridevirtual

Generate Json::Value for this object.

Implements openshot::ReaderBase.

Definition at line 200 of file QtTextReader.cpp.

Referenced by Json().

◆ Name()

std::string openshot::QtTextReader::Name ( )

inlineoverridevirtual

Return the type name of the class.

Implements openshot::ReaderBase.

Definition at line 123 of file QtTextReader.h.

◆ Open()

void QtTextReader::Open ( )

overridevirtual

Open Reader - which is called by the constructor automatically.

Implements openshot::ReaderBase.

Definition at line 50 of file QtTextReader.cpp.

Referenced by QtTextReader(), SetJsonValue(), and SetTextBackgroundColor().

◆ SetJson()

void QtTextReader::SetJson ( const std::string value )

overridevirtual

Load JSON string into this object.

Implements openshot::ReaderBase.

Definition at line 221 of file QtTextReader.cpp.

◆ SetJsonValue()

void QtTextReader::SetJsonValue ( const Json::Value root )

overridevirtual

Load Json::Value into this object.

Implements openshot::ReaderBase.

Definition at line 238 of file QtTextReader.cpp.

Referenced by SetJson().

◆ SetTextBackgroundColor()

void QtTextReader::SetTextBackgroundColor ( std::string color )

Draw a box under rendered text using the specified color.

Parameters

color The background color behind the text (valid values are a color string in #RRGGBB or #AARRGGBB notation or a CSS color name)

Definition at line 41 of file QtTextReader.cpp.

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

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QtTextReader() [1/2]

◆ QtTextReader() [2/2]

Member Function Documentation

◆ Close()

◆ GetCache()

◆ GetFrame()

◆ IsOpen()

◆ Json()

◆ JsonValue()

◆ Name()

◆ Open()

◆ SetJson()

◆ SetJsonValue()

◆ SetTextBackgroundColor()