Plugin:Clist modern/en/Skin development guide - Revision history

Dart Raiden: /* Buttons description */

2021-03-18T16:00:47Z

Buttons description

← Older revision		Revision as of 19:00, 18 March 2021
Line 140:		Line 140:

	== Buttons description ==		== Buttons description ==
	Buttons can be placed in any area of the window (but prefer on margins, otherwise, they will be covered by frames.		Next part describes buttons. Buttons can be placed in any area of the window (but prefer on margins, otherwise, they will be covered by frames.

	Buttons can be to types Push and Switch.		Buttons can be to types Push and Switch.

Dart Raiden: /* Objects description */

2021-03-18T15:42:19Z

Objects description

← Older revision		Revision as of 18:42, 18 March 2021
Line 92:		Line 92:
	$object_name=sGlyph,object_type,parameters,…		$object_name=sGlyph,object_type,parameters,…
	</pre>		</pre>
	object_name — object name used to point from rules		object_name — object name used to point from rules.

	object_type — one of types: Image or Solid		object_type — one of types: Image or Solid.

	parameters,… — list of parameters, the order of which is determined depending on the type of object:		parameters,… — list of parameters, the order of which is determined depending on the type of object:

Dart Raiden: /* Work algorithm */

2021-03-18T15:34:51Z

Work algorithm

← Older revision		Revision as of 18:34, 18 March 2021
Line 12:		Line 12:
	# Module generates request string as soon as it needs to paint something and give it to skin engine.		# Module generates request string as soon as it needs to paint something and give it to skin engine.
	# Skin engine tries to find the first rule that corresponds to the given request and select an object that is pointed by this rule.		# Skin engine tries to find the first rule that corresponds to the given request and select an object that is pointed by this rule.
	# If the selected object is ~~solid~~ type: the requested area is painted by the corresponding color with specified alpha.		# If the selected object is Solid type: the requested area is painted by the corresponding color with specified alpha.
	# If the selected object is an ~~image~~: such image is transformed to requested region size and paints.		# If the selected object is an Image: such image is transformed to requested region size and paints.

	== Rules and requests ==		== Rules and requests ==

Dart Raiden: /* Rule description */

2021-03-18T14:40:11Z

Rule description

← Older revision		Revision as of 17:40, 18 March 2021
Line 124:		Line 124:

	== Rule description ==		== Rule description ==
	Next part describes ~~Rules~~. Rules are described in next way:		Next part describes rules. Rules are described in next way:
	<pre style="overflow:auto;">		<pre style="overflow:auto;">
	@rule_number=s$object_name:Module_parameter_value,param_name=value,parameter_name^value,…		@rule_number=s$object_name:Module_parameter_value,param_name=value,parameter_name^value,…

Dart Raiden: /* Objects description */

2021-03-18T14:39:58Z

Objects description

← Older revision		Revision as of 17:39, 18 March 2021
Line 86:		Line 86:

	== Objects description ==		== Objects description ==
	So skin consists of several parts. One of them describes ~~Objects~~.		So skin consists of several parts. One of them describes objects.

	Objects are described in next way:		Objects are described in next way:
Line 94:		Line 94:
	object_name — object name used to point from rules		object_name — object name used to point from rules

	object_type — one of types Image or Solid		object_type — one of types: Image or Solid

	parameters,… — list of parameters, the order of which is determined depending on the type of object:		parameters,… — list of parameters, the order of which is determined depending on the type of object:


	for ~~Solid~~ type:		for solid type:
	<pre style="overflow:auto;">		<pre style="overflow:auto;">
	$object_name =sGlyph,Solid,RedValue,GreenValue,BlueValue,AlphaValue		$object_name =sGlyph,Solid,RedValue,GreenValue,BlueValue,AlphaValue
Line 106:		Line 106:


	for ~~Image~~:		for image:
	<pre style="overflow:auto;">		<pre style="overflow:auto;">
	$object_name =sGlyph,Image,File_Name,Fit_Mode,Left,Top,Right,Bottom,AlphaValue		$object_name =sGlyph,Image,File_Name,Fit_Mode,Left,Top,Right,Bottom,AlphaValue

Dart Raiden at 14:38, 18 March 2021

2021-03-18T14:38:13Z

← Older revision		Revision as of 17:38, 18 March 2021
Line 3:		Line 3:
	== Common definitions ==		== Common definitions ==
	Skin engine is based on next definitions and concepts:		Skin engine is based on next definitions and concepts:
	* Object — component of skin. All skin objects are created during module loading. Objects describe what and how is need to paint as a reply to the ~~Request~~.		* Object — component of skin. All skin objects are created during module loading. Objects describe what and how is need to paint as a reply to the request.
	* Glyph — some image. Now time is supported BMP, JPG, and PNG (with transparency). The size of a glyph is defined by image size. Glyph picture loads to memory only at the first attempt to paint it and is kept in memory till module unloading or another skin loading.		* Glyph — some image. Now time is supported BMP, JPG, and PNG (with transparency). The size of a glyph is defined by image size. Glyph picture loads to memory only at the first attempt to paint it and is kept in memory till module unloading or another skin loading.
	* Rule — a rule which ~~Object~~ corresponds to ~~Request~~.		* Rule — a rule which object corresponds to request.
	* Request — request from a module (this or other) to paint one of the corresponding objects at a specific place and size.		* Request — request from a module (this or other) to paint one of the corresponding objects at a specific place and size.

	== Work algorithm ==		== Work algorithm ==
	Skin engine sequence is next:		Skin engine sequence is next:
	# Module generates ~~Request~~ string as soon as it needs to paint something and give it to skin engine.		# Module generates request string as soon as it needs to paint something and give it to skin engine.
	# Skin engine tries to find the first rule that corresponds to the given request and select an object that is pointed by this rule.		# Skin engine tries to find the first rule that corresponds to the given request and select an object that is pointed by this rule.
	# If the selected object is ~~Solid~~ type: the requested area is painted by the corresponding color with specified alpha.		# If the selected object is solid type: the requested area is painted by the corresponding color with specified alpha.
	# If the selected object is an ~~Image~~: such image is transformed to requested region size and paints.		# If the selected object is an image: such image is transformed to requested region size and paints.

	== Rules and ~~Requests~~ ==		== Rules and requests ==
	A rule consists of:		A rule consists of:
	# number;		# number;
Line 26:		Line 26:
	* parameter value.		* parameter value.

	A ~~Request~~ has the same part as the rule except for number.		A request has the same part as the rule except for number.

	The rule corresponds to the request if:		The rule corresponds to the request if:

Dart Raiden: /* Rule description */

2021-03-18T14:33:26Z

Rule description

← Older revision		Revision as of 17:33, 18 March 2021
Line 124:		Line 124:

	== Rule description ==		== Rule description ==
	Rules are described in next way:		Next part describes Rules. Rules are described in next way:
	<pre style="overflow:auto;">		<pre style="overflow:auto;">
	@rule_number=s$object_name:Module_parameter_value,param_name=value,parameter_name^value,…		@rule_number=s$object_name:Module_parameter_value,param_name=value,parameter_name^value,…

Dart Raiden: /* Objects description */

2021-03-18T14:29:27Z

Objects description

← Older revision		Revision as of 17:29, 18 March 2021
Line 96:		Line 96:
	object_type — one of types Image or Solid		object_type — one of types Image or Solid

	parameters,… — parameters.		parameters,… — list of parameters, the order of which is determined depending on the type of object:

Dart Raiden at 21:07, 14 March 2021

2021-03-14T21:07:21Z

Show changes

Dart Raiden: /* Rules and Request */

2021-03-14T20:44:08Z

Rules and Request

← Older revision		Revision as of 23:44, 14 March 2021
Line 32:		Line 32:
	# All values of common parameters are the same if rule's parameters condition is "equal" and not the same if rules condition is "not equal".		# All values of common parameters are the same if rule's parameters condition is "equal" and not the same if rules condition is "not equal".

	Rule parameter values can contain wildcards "*" and "?". Rule parameter's names and values can contain up to 24 chars. Values can not contain "," (comma) all commas are replaced by "." (dots). Names and values are case sensitive~~. First parameter name should be skipped when points~~.		Rule parameter values can contain wildcards "*" and "?". Rule parameter's names and values can contain up to 24 chars. Values can not contain "," (comma) all commas are replaced by "." (dots). Names and values are case sensitive.

	== Glyph transformation ==		== Glyph transformation ==