optical-properties

WebJar for optical-properties

License	MIT
GroupId	org.webjars.npm
ArtifactId	optical-properties
Last Version	1.0.0
Release Date	Mar 5, 2018
Type	jar
Description	optical-properties WebJar for optical-properties
Project URL	http://webjars.org
Source Code Management	https://github.com/dfcreative/optical-properties

Download optical-properties

Filename	Size
optical-properties-1.0.0.pom
optical-properties-1.0.0.jar	8 KB
optical-properties-1.0.0-sources.jar	22 bytes
optical-properties-1.0.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/optical-properties/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>optical-properties</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/optical-properties/
implementation 'org.webjars.npm:optical-properties:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/optical-properties/
implementation ("org.webjars.npm:optical-properties:1.0.0")

Apache Buildr

'org.webjars.npm:optical-properties:jar:1.0.0'

Apache Ivy

<dependency org="org.webjars.npm" name="optical-properties" rev="1.0.0">
  <artifact name="optical-properties" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='optical-properties', version='1.0.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "optical-properties" % "1.0.0"

Leiningen

[org.webjars.npm/optical-properties "1.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

optical-properties

Get optical params of a character, canvas or image data. Useful to do kerning, normalize size or adjust vertical/horizontal alignment.

See demo.

Usage

const optics = require('optical-properties')

let w = canvas.width, h = canvas.height, ctx = canvas.getContext('2d')

//get optical params
let {bounds, center, radius} = optics('▲', {size: h, fontSize: h/2})

//make sure radius of char is at least half of canvas height
let scale = h*.5 / (radius*2)

//optical center shift from the real center
let diff = [w*.5 - center[0], h*.5 - center[1]]

//draw normalized character
ctx.font = size*cale + 'px sans-serif'
ctx.fillText('▲', w*.5 + diff[0]*scale, h*.5 + diff[1]*scale)

API

let props = optics(char|canvas|imageData, options?)

Measures optical properties of a character, canvas or imageData based on options. Canvas is expected to be rectangular.

Options:

• size − size of canvas to use, bigger is slower but more precise and vice-versa. Defaults to 200.
• fontFamily − font family to use for the character, defaults to sans-serif.
• fontSize − size of glyph, defaults to 100.

Returns object with properties:

• center − coordinates of optical center as [cx, cy].
• bounds − character bounding box [left, top, right, bottom].
• radius − distance from the optical center to the outmost point.

Credits

© 2017 Dima Yv. MIT License

Versions

Version
1.0.0 Mar 5, 2018