docs

Compositional graphics for Scala

License

License

Categories

Categories

Scala Languages
GroupId

GroupId

org.creativescala
ArtifactId

ArtifactId

docs_2.12
Last Version

Last Version

0.9.21
Release Date

Release Date

Type

Type

jar
Description

Description

docs
Compositional graphics for Scala
Project URL

Project URL

https://github.com/creativescala/doodle
Project Organization

Project Organization

Noel Welsh
Source Code Management

Source Code Management

https://github.com/creativescala/doodle

Download docs_2.12

How to add to project

<!-- https://jarcasting.com/artifacts/org.creativescala/docs_2.12/ -->
<dependency>
    <groupId>org.creativescala</groupId>
    <artifactId>docs_2.12</artifactId>
    <version>0.9.21</version>
</dependency>
// https://jarcasting.com/artifacts/org.creativescala/docs_2.12/
implementation 'org.creativescala:docs_2.12:0.9.21'
// https://jarcasting.com/artifacts/org.creativescala/docs_2.12/
implementation ("org.creativescala:docs_2.12:0.9.21")
'org.creativescala:docs_2.12:jar:0.9.21'
<dependency org="org.creativescala" name="docs_2.12" rev="0.9.21">
  <artifact name="docs_2.12" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.creativescala', module='docs_2.12', version='0.9.21')
)
libraryDependencies += "org.creativescala" % "docs_2.12" % "0.9.21"
[org.creativescala/docs_2.12 "0.9.21"]

Dependencies

compile (3)

Group / Artifact Type Version
org.scala-lang : scala-library jar 2.12.10
org.creativescala : doodle_2.12 jar 0.9.21
org.scalameta : mdoc_2.12 jar 2.1.1

Project Modules

There are no modules declared in this project.

Doodle: Compositional Vector Graphics

Copyright Noel Welsh.

Doodle is a Scala library for compositional vector graphics.

Distributed under the Apache 2.0 license.

Build Status

Using Doodle

The current release is 0.9.21 and is on the master branch.

To use doodle add the following to your build.sbt:

scalaVersion := "2.13.1" // Doodle is currently published for Scala 2.12 and 2.13
libraryDependencies += "org.creativescala" %% "doodle" % "0.9.21"

Alternatively you can git clone or download Doodle and use it directly from the SBT console. See the instructions below.

Documentation

Documentation is still a work-in-progress.

Creative Scala provides another source of documentation for Doodle. Creative Scala is a free introductory Scala ebook.

Below we have a few tips to get you started.

Getting Started from SBT

If you downloaded Doodle, rather than adding it to an existing Scala project, you can play around with it as follows.

  1. Start SBT:

    bash$ sbt
    
    > # This is the SBT prompt. Press Ctrl+D to quit to the OS.
  2. Start the console:

    > rootJVM/console
    
    scala> # This is the Scala prompt. Press Ctrl+D to quit to SBT.
  3. Use Scala commands to draw a shape in a native window:

    scala> (Image.circle(10).fillColor(Color.red)).draw()

    A window should appear containing a red circle.

  4. You can also save your masterpieces to a file.

    scala> (Image.circle(10).fillColor.(Color.red)).write[Png]("masterpiece.png")

    Doodle currently supports writing to PNG, GIF, and JPG formats. Just alter the type parameter of write accordingly.

Acknowledgements

Doodle was written by Noel Welsh with contributions from the contributors listed by Github.

Notes

These are notes for developers.

Documentation

To generate the documentation run the documentation task in SBT without changing to any project. If you do the task just seems to disappear. I have no idea why. The output will be in docs/target/docs. Copy this to the website and upload.

If you run out of metaspace you can punch SBT in the face. Alternatively run just the documentation task (i.e. sbt documentation) and it seems to be happier.

Publishing

To publish a release:

  • update the version number on master in publish.sbt
  • update the version number in README.md
  • run + publishSigned
  • run sonatypeBundleRelease
  • tag master with the release version
  • push tags to origin.
org.creativescala

Creative Scala

Versions

Version
0.9.21
0.9.20
0.9.19
0.9.18
0.9.17
0.9.16
0.9.15
0.9.14
0.9.13
0.9.12
0.9.11
0.9.10
0.9.9
0.9.8
0.9.7
0.9.6
0.9.5
0.9.4
0.9.3
0.9.2