Eskin artwork variables - accident12123/eversion GitHub Wiki


The artwork scanner may have been canceled by the yamj team.. These do add a little more cpu needs to process, it might be better to skip these for now.

=# ESKIN: Jukebox Artwork Variables =

The YAMJ Team has been working on a new artwork scanner for YAMJ. This version when completed will offer many artwork options that you might want to start using in your eskin immediately. Our new artwork variables support both existing YAMJ and the new Scanner so there is nothing special a user with your eskin needs to do.

Eskin Design Options

The new artwork system will bring you the following choices:

  • Multiple images of the same artwork type
  • Multiple sizes to help keep flash running optimum and users not needing to adjust eversion YAMJ settings.
  • new tv artwork (see fanart.tv for examples)

Format

(is)(smart){artwork type}{#}{size}

is (optional)

Just add is to the start of the variable to get YES or NO if there is that artwork type available.

smart (optional)

Smart is used to find the best possible alternative when your choice isn't available. This will allow you to do things like "fanart4" and if there is only 1 fanart image for that title something will show up on the screen. We strongly recommend you use all the new artwork variable with smart.

See how smart works below for more details.

artwork type (required)

The name of the artwork image you want

Choices:

  • poster
  • fanart
  • banner
  • tvthumb
  • seasonthumb
  • clearart
  • clearlogo

Where's videoimage? At the moment videoimage is a special case and you should use the variable in the episode list. We'll convert it over as soon as the artwork system is far enough along to work with it.

# (required)

This is the image # your looking for. If your eskin design might make use of 4 different fanart images. If you wanted image 3, you put 3 here.

size (required)

The size of the artwork you want.

Choices:

  • small
  • medium
  • large
  • original

What do these really mean? This is TBD at the moment as we sort it out ourselves but you'll probably want small for index screen, large for detail screens.

How smart works

Adding smart to your variable name is going to be the best option to make sure you get something to appear on the screen. Below is a list of what it looks at to find you an image.

  • The size image you asked for or larger in the same #
  • The size image you asked for or larger in the #'s before your choice.

Example: smartposter2large

  • is there 2 in large?
  • is there 2 in original?
  • is there 1 in large?
  • is there 1 in original?
  • send back UNKNOWN (NO if you added is to the variable name)

How non-artwork users work

Because existing YAMJ does have all the artwork options. We convert the variable to the best choice of what it does have. In the case of completely new artwork types, they always return UNKNOWN.

However, that may not be a bad thing. Remember you can use if/condition to pick alternative on screen information. So you can have a tvthumb index screen that shows the tv show name in text when the artwork isn't available.

Special info about TVTHUMB

(WORK IN PROGRESS, NOT FULLY FUNCTIONAL BUT USE THE VARS NOW).

tvthumbs are the series image. seasonthumbs are the per season image. when you use tvthumb, we'll automatically pick the best option for what your asking for artwork about.