Anshorei
/
squib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

ok last tweaks i swear

dev
Andy Meneely 2021-07-23 11:52:13 -04:00
parent 6463313959
commit 27b3be4744
2 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/dsl/save_png.rst
View File

@ -48,7 +48,9 @@ shadow_radius
A larger radius extends the blur's spread, making it softer. A radius of 0 still enables the shadow, but has no blur. A larger radius extends the blur's spread, making it softer. A radius of 0 still enables the shadow, but has no blur.
See section below for details about drop shadows. Recommended range: 3-10 pixels.
See :ref:`shadow` section below for more details.
shadow_offset_x shadow_offset_x
default: ``3`` default: ``3``
@ -56,7 +58,7 @@ shadow_offset_x
the horizontal distance that the drop shadow will be shifted beneath the final image. the horizontal distance that the drop shadow will be shifted beneath the final image.
Ignored when ``shadow_radius`` is ``nil``. Ignored when ``shadow_radius`` is ``nil``.
See section below for details about drop shadows. See :ref:`shadow` section below for more details.
Supports :doc:`/units`. Supports :doc:`/units`.
@ -65,7 +67,7 @@ shadow_offset_y
Ignored when `shadow_radius` is ``nil``. See ``shadow_radius`` above for drop shadow details. Ignored when `shadow_radius` is ``nil``. See ``shadow_radius`` above for drop shadow details.
See section below for details about drop shadows. See :ref:`shadow` section below for more details.
Supports :doc:`/units`. Supports :doc:`/units`.
@ -74,7 +76,7 @@ shadow_trim
the space around the lower right and bottom edge of the output image to be trimmed when a drop shadow is drawn. Can also enlarge the image if it is negative. the space around the lower right and bottom edge of the output image to be trimmed when a drop shadow is drawn. Can also enlarge the image if it is negative.
Ignored when `shadow_radius` is ``nil``. See section below for details about drop shadows. Ignored when `shadow_radius` is ``nil``. See :ref:`shadow` section below for more details.
Supports :doc:`/units`. Supports :doc:`/units`.
@ -85,10 +87,12 @@ shadow_color
`Note about gradients:` Squib still does blurring, but gradients give you fine control over the softness of the shadow. See example below of doing a custom gradient for customizing your look. `Note about gradients:` Squib still does blurring, but gradients give you fine control over the softness of the shadow. See example below of doing a custom gradient for customizing your look.
See section below for details about drop shadows. See :ref:`shadow` section below for more details.
.. include:: /args/range.rst .. include:: /args/range.rst
.. _shadow:
Drop Shadow Drop Shadow
----------- -----------
@ -97,11 +101,9 @@ Drop shadows don't modify the original image. Instead, this will paint your exis
* ``final_width = card_w + shadow_offset_x + (3 * shadow_radius) - (2 * shadow_trim) - (2 * trim)`` * ``final_width = card_w + shadow_offset_x + (3 * shadow_radius) - (2 * shadow_trim) - (2 * trim)``
* ``final_height = card_h + shadow_offset_y + (3 * shadow_radius) - (2 * shadow_trim) - (2 * trim)`` * ``final_height = card_h + shadow_offset_y + (3 * shadow_radius) - (2 * shadow_trim) - (2 * trim)``
A shadow of your card graphic is created using your ``shadow_color``.
The image will be painted at ``shadow_radius, shadow_radius`` in the new image. See https://github.com/rcairo/rcairo/blob/master/lib/cairo/context/blur.rb for details on blur implementation. Supports :doc:`/units`.
This drop shadow happens before rendering and does not alter the original card graphic.
At this stage, the feature will just draw a rectangle and blur from there. So if your card has transparency (other than from ``trim_radius``), from, say, a circular chit, then this won't work. We're working on a better implementation.
See [blur algorithm](https://github.com/rcairo/rcairo/blob/master/lib/cairo/context/blur.rb) for details on blur implementation. Recommended range: 3-10 pixels. Supports :doc:`/units`.
Examples Examples
-------- --------

1
samples/shadows/_shadow.rb
View File

@ -64,7 +64,6 @@ Squib::Deck.new(width:50, height: 50) do
png file: 'doodle.png' png file: 'doodle.png'
# save_png prefix: 'no_bg_shadow_', shadow_radius: 8, shadow_offset_x: 3, shadow_offset_y: 3
save_png prefix: 'transparent_bg_shadow_', save_png prefix: 'transparent_bg_shadow_',
shadow_radius: 2, shadow_radius: 2,
shadow_offset_x: 2, shadow_offset_y: 2, shadow_offset_x: 2, shadow_offset_y: 2,