Les filtres d'image peuvent être appliqués pour améliorer les images lors de la génération de l'album, pour ajouter un filigrane, un logo, etc. Les filtres d'image peuvent être appliqués aux images, aux vignettes ou aux deux. Les combinaisons autorisées sont répertoriées ici. Plusieurs filtres peuvent être enchaînés pour produire l'effet désiré. Imaginez l'application en premier la réduction des yeux rouges, puis la netteté d'image et enfin ajouter votre logo dans un coin. Un exemple de l'API et le code open source sont fournis afin que les développeurs puissent facilement ajouter de nouveaux filtres.

Dans le panneau d'effets vous pouvez facilement ajouter des filigranes (texte et/ou logo), niveaux de gris, contrastes et quelques filtres Arty. Tous les filtres disponibles ne sont pas ajoutés dans l'interface utilisateur, ils peuvent être contrôlés avec des paramètres assez simples dans la section "Variables utilisateur" de "Page -> Avancées". Ces filtres peuvent être appliqués globalement et sur une base dossier par dossier ou même sur une image individuelle.

Petit exemple

Comme apprendre par l'exemple est le meilleur, nous allons donc commencer par appliquer un filtre en niveaux de gris à chaque vignette et ajouter un copyright de droit d'auteur à l'angle de chaque image agrandie. (Pour une description formelle des fonctionnalités de filtrage disponibles, voir ci-dessous.)

Démarrez l'application jAlbum et préparer un projet pour la création de l'album. Maintenant, allez à la page Avancées de jAlbum. Vous y trouverez une section appelée "Variables utilisateur". Nous allons utiliser cette section pour définir les propriétés de nos filtres. Entrez exactement comme le montre cet exemple. Faites attention aux majuscules, ("GrayscaleFilter" est différent de Grayscalefilter").

Définition des propriétés de filtre sur la page Avancées

Allez maintenant à la page principale et appuyez sur "Forcer Recréer Tout" pour générer l'album et appliquer les filtres. (Appuyer sur 'Forcer Recréer Tout' est important car appuyer sur 'Créer l'album' ne traite pas les images si elles existent déjà d'une génération d'album précédente.) Les vignettes et les images devraient maintenant ressembler à ceci :

La vignette et l'image traitées par les filtres niveaux de gris et texte

Les filtres sont appliqués dans l'ordre où ils sont numérotés (filter1, filtre2 etc). Les paramètres de filtre sont enregistrés avec le projet, alors n'oubliez pas de sauvegarder votre projet lorsque vous êtes satisfait de vos paramètres.

Les filtres

Voici une liste des filtres initialement prévus et leurs propriétés (fonctions). De nouveaux filtres peuvent être installés en mettant leurs fichiers de classe Java dans le dossier plugins de jAlbum. Tous les filtres nécessitent d'avoir la propriété de classe indiquée comme identificateur de filtre. Tous les filtres acceptent les propriétés thumnails et closeup qui contrôlent si le filtre doit être appliqué seulement aux vignettes, aux images ou aux deux à la fois. Par défaut, les filtres s'appliquent aux deux à la fois.

Remarquez le caractère '|' représente 'ou', donc true | false signifie que la valeur peut être vraie ou fausse

Il manque un filtre ? S'il vous plaît chercher également des filtres faits par les utilisateurs de jAlbum dans le forum.

Filtre Niveaux de gris

Convertit les images en niveau de gris.

Exemple

class=GrayscaleFilter

Applique le filtre gris à la fois aux vignettes et aux images.

Filtre Teinte

Permet de régler la couleur des images.

Exemple

class=TintFilter redPercent=100 greenPercent=60 bluePercent=60

Applique une teinte rougeâtre aux images.

Vous pouvez obtenir des effets intéressants en combinant le filtre niveaux de gris avec le filtre Teinte.

Filtre Logotype

Ajoute une image/logo de votre choix sur les images de l'album

Exemples

class=LogoFilter src="http://blog.jalbum.net/dor.png" strengthPercent="50" closeups

Ajoute un logo jAlbum à partir de l'URL (adresse web) du site web de jAlbum, au centre des images.

class=LogoFilter src="file:///C:/adir/anotherdir/animage.jpg" closeups

Ajoute une image depuis le disque dur local au lieu d'un emplacement distant.

Exclure une image

Vous pouvez exclure une image individuelle du filtre de logotype associé à l'ensemble de l'album en l'ouvrant pour modification dans jAlbum, en ouvrant le panneau Variables à droite et en entrant une nouvelle variable portant le nom applyLogo et une valeur de false.

Filtre Texte

Ajoute des textes aux images de l'album.

Exemple

class=TextFilter text="Date: $fileDate" referenceWidth=800 size=20 color=#aaffaa closeups

Ajoute la date de fichier de l’image au-dessus de l’image dans une couleur vert clair, ajuste la taille de la police si la taille de l’image diffère de la largeur de référence.

Filtre Ombre du Texte

Comme le filtre texte mais ajoute également une ombre portée.

Propriétés spécifiques (voir filtre texte pour les autres)

Exemple

class=ShadowTextFilter text="Date: $fileDate" size=20 color=#aaffaa closeups
Pour vous assurer que la date utilisée est la date à laquelle la photo a été prise, utilisez originalDate (fileDate peut être modifié)

Ajoute la date du fichier de l'image en haut dans une couleur vert clair avec une ombre noire.

Filtre Filigrane

Comme le filtre texte mais avec un effet de filigrane

Exemple

class=WatermarkFilter text="jAlbum" size=30  closeups valign=bottom margin=0

Ajoute un filigrane "jAlbum" près du bord gauche inférieur

Filtre Zoom

Zoom sur les images. Utile pour rendre les vignettes plus lisibles

Exemple

class=ZoomFilter prescale thumbnails zoomPercent=30

Applique le filtre zoom aux vignettes. Notez l'attibut "prescale" (important pour les vignettes)

Filtre Forme Fixe

Coupe les images de façon à correspondre exactement aux valeurs fixées dans l'interface pour "Taille des vignettes" ou "Taille des images". Il en résulte que toutes les images et vignettes ou juste les vignettes ont le même format. (portrait, carré, etc.).

Exemple

class=FixedShapeFilter prescale thumbnails

Applique le filtre forme fixe aux vignettes. Notez l'attribut prescale très important.

Le filtre FixedShape doit être utilisé à la fois pour les vignettes et les images avant que le redimensionnement ait lieu ou sur les vignettes uniquement, avant que le redimensionnement n'ait lieu.

Il ne supporte pas la combinaison de "closeups" et "prescale", si les deux sont utilisés, le "prescale" sera ignoré.

Filtre de contrainte de rapport

Limite le format d’image d’une image traitée. Cela empêche les images panoramiques, par exemple, de produire de longues vignettes maigres.

Exemple

class=ConstrainRatioFilter prescale thumbnails maxRatio=2.5

Applique le filtre de rapport de contrainte aux vignettes et limite le rapport L/H de sortie (largeur/hauteur) à un maximum de 2,5.

Notez que de nombreux skins incluent ce filtre par défaut ou en tant qu’option de case à cocher du skin. Vérifiez le skin que vous utilisez avant de l’appliquer manuellement.

Filtre Accentuation

Accentuer les images

Exemple

class=SharpenFilter closeups

Applique une augmentation de la netteté aux images.

Filtre Flou

Donne du flou aux images

Exemple

class=BlurFilter closeups

Applique un flou aux images.

NameTagFilter

Filtre balise de nom.

Ajoute une petite étiquette à l’aide du nom entré dans Set area tags... ou à partir des données des régions XMP. L’étiquette apparaît sur les images au même endroit que celui indiqué dans la section 'Définir les balises de zone...' Aperçu..

Exemple

class=NameTagFilter closeups

Applique le filtre aux images.

Filtre Marge

Ajoute une marge.

Ajoute une marge de n pixels autour de chaque image. Par défaut, la marge est transparente (si vous générez des images PNG), mais toute couleur avec n'importe quel niveau de transparence fonctionne. Depuis v18.3

Exemple

class=MarginFilter margin=10 color=#33AAAAAA

Applique une marge gris clair semi-transparente de 10 pixels autour des images

Filtre étendu Bordure

Ajoute des bordures, cadres et ombres de votre choix aux images d'albums.

Exemples

Ajoute un cadre et une ombre portée à vos grandes images.

class=XBorderFilter frWidth=20 frCol=ivory shWidth=15 closeups

Ajoute une bordure à vos grandes images.

class=XBorderFilter boWidth=20 boCol=ivory closeups

Exclure des images des filtres

Vous pouvez exclure une image individuelle des filtres appliqués globalement.

Dans mode Editer, ajoutez une variable utilisateur spécifique à l’image appelée "excludeFilters". Définissez la valeur sur le nom de la classe de filtre (ou les noms des classes de filtre, séparés par des virgules).

Ajout de filtres aux skins

Voici un exemple d’ajout de filtres d’image à un skin, dans ce cas il s’agit d’un filtre de filigrane ; watermark et watermarkSize seraient des variables d’apparence de onload.bsh. Le code est ajouté à init.bsh.

if (watermark.length() > 0) {
	WatermarkFilter f = new WatermarkFilter();
	f.setText(watermark);
	f.setSize(watermarkSize);
	f.setAlign("center");
	f.setValign("bottom");
	engine.addFilter(f, 3);
}

Et pour ajouter le filtre de rapport de contrainte pour les vignettes :

engine.addFilter(new ConstrainRatioFilter(0.5f, 2f), JAFilter.THUMBNAILS_PRESCALE_STAGE);

Extension des filtres d'image de jAlbum

Cette section est destinée aux programmeurs Java qui souhaitent améliorer jAlbum avec de nouveaux filtres d'image.

Les filtres d'image jAlbum sont des classes java, ajoutées dans le répertoire de plugins qui implémentent la petite Interface se.datadosen.jalbum.JAFilter. Un filtre jAlbum devrait également respecter la spécification JavaBean, Direction :

• Fournir un constructeur non-argumenté
• Les méthodes getters et setter doivent suivre la convention de nommage JavaBean.
• Le filtre doit être sérialisable

Une interface se.datadosen.jalbum.JAFilter doit fournir des méthodes getter pour le nom et une description à peu près comme une Applet. La troisième méthode est la méthode de filtre qui prend comme arguments un BufferedImage et une java.util.Map et retourne un BufferedImage modifié. Un filtre est autorisé à manipuler directement le BufferedImage passé. L'objet Map contient des $variables jAlbum qui peuvent être utiles pour la mise en œuvre du filtre.

La meilleure façon de passer des paramètres à un filtre doit implémenter les méthodes setter pour eux. En utilisant un script BeanShell intelligent dans le fichier init.hsh dans le dossier du programme jAlbum, jAlbum est capable de passer des attributs pour la méthode setter correspondant d'un filtre.pour l'onglet Variables utilisateur de la page Avancées.

Le dossier plugins de jAlbum contient non seulement les classes de filtres, mais aussi le code source pour les filtres décrits sur cette page. Sentez-vous libre de les utiliser comme base pour vos propres filtres. Vous trouverez ci-dessous un filtre simple probablement une bonne base pour vos propres filtres. Le dossier plugins contient également un fichier compile.bat qui vous simplifie la compilation. Lorsque vous développez des filtres, s'il vous plaît noter que vous n'avez pas besoin de redémarrer jAlbum afin de rafraîchir les classes de filtre car elles sont chargées dynamiquement chaque fois qu'un album est en cours de traitement. Enfin, si vous faites un filtre cool, s'il vous plaît envoyer-le moi pour l'inclusion.

Exemple Code source de filtre

Le filtre simple suivant ajoute un logo jAlbum dans le coin des images :

import se.datadosen.jalbum.JAFilter;
import java.awt.*;
import java.awt.image.BufferedImage;
import javax.swing.ImageIcon;

/**
 * jAlbum simple image filter adding a jAlbum logo to the
 * corner of images
 * @author David Ekholm
 * @version 1.0
 */
public class SimpleFilter implements JAFilter {

    // Implements JAFilter
    public String getName() {
        return "Simple filter";
    }

    // Implements JAFilter
    public String getDescription() {
        return "Add a jAlbum logo to the corner of images";
    }

    // Implements JAFilter
    public BufferedImage filter(BufferedImage bi, java.util.Map vars) {
        Graphics2D g = bi.createGraphics();
        ImageIcon windowIcon =
         new ImageIcon(se.datadosen.jalbum.JAlbumFrame.class.getResource(
          "smallicon.gif"));
        g.drawImage(windowIcon.getImage(), 0, 0, null);
        return bi;
    }
}

Plus d'exemples

Ajout d'une zone rouge haute de 30px au bas des images de diapositive avec une adresse Web en texte blanc.

Pour que les images aient la même surface ou le même nombre de pixels, voir le message du forum LimitAreaFilter.