Producing Fallback Avatars Utilizing CFImage And ColdFusion

ADD ./fonts /usr/share/fonts/truetype

element
	accessors = true
	output = false
	trace = "I generate easy, initials-based avatars."
	{

	// Outline properties for dependency-injection.
	property scratchDisk;

	// ---
	// PUBLIC METHODS.
	// ---

	/**
	* I generate an initials-based avatar and return the picture binary. The picture is all the time
	* generated as a JPG as a way to match what Gravatar makes use of.
	*/
	public binary perform generateAvatar(
		required string initials,
		required numeric measurement
		) {

		var imageData = withTempDirectory(
			( tempDirectory ) => {

				var picture = imageNew( "", measurement, measurement, "rgb", "212121" );
				picture.setDrawingColor( "ffffff" );
				picture.setAntialiasing( true );

				var fontProperties = {
					font: "Roboto Mono Common",
					measurement: ( repair( measurement / 3 ) - 2 )
				};
				// Since we do not know what textual content goes to be handed into the perform,
				// we have to "measure" the textual content that will probably be rendered to the picture when
				// utilizing the given textual content worth and font properties. We will then use this
				// to middle the textual content inside the canvas measurement.
				var bounds = measureText( picture, initials, fontProperties );
				// Heart textual content horizontally.
				var x = ( ( measurement / 2 ) - ( bounds.width / 2 ) - bounds.xOffset );
				// Heart textual content vertically.
				var y = ( ( measurement / 2 ) + ( bounds.peak / 2 ) );

				picture.drawText( initials, x, y, fontProperties );

				// Save the picture object to disk (Digital File System on this case, for
				// quick file I/O operations).
				var imagePath = ( tempDirectory & "/avatar.jpg" );
				picture.write( imagePath, 0.80 );

				return( fileReadBinary( imagePath ) );

			}
		);

		return( imageData );

	}

	// ---
	// PRIVATE METHODS.
	// ---

	/**
	* I get the bounding field dimensions of the given textual content as it will seem written to
	* the given picture.
	*/
	non-public struct perform measureText(
		required any picture,
		required string textual content,
		required struct fontProperties
		) {

		var awtContext = picture.getBufferedImage()
			.getGraphics()
			.getFontRenderContext()
		;
		// CAUTION: When decoding a font definition, you should utilize both an area (" ") or
		// a touch ("-") delimiter. However, you can not mix-and-match the 2 characters. As
		// such, when you have a Font title which has areas in it (ex, "Roboto Mono"), you
		// MUST USE the sprint delimiter as a way to stop Java from parsing the font title
		// as a multi-item record. On this case, be aware that I'm utilizing the "-" as a result of I do know
		// my font title does not comprise a touch.
		var awtFont = createObject( "java", "java.awt.Font" )
			.decode( "#fontProperties.font#-#fontProperties.measurement#" )
		;
		var bounds = createObject( "java", "java.awt.font.TextLayout" )
			.init( textual content, awtFont, awtContext )
			.getBounds()
		;

		return({
			width: bounds.width,
			peak: bounds.peak,
			xOffset: bounds.x,
			yOffset: bounds.y
		});

	}


	/**
	* I execute the given callback, passing in a brief listing that can be utilized for
	* transient file IO. The non permanent listing is deleted after the callback has been
	* executed.
	*/
	non-public any perform withTempDirectory( required perform callback ) {

		var folderPath = ( scratchDisk & "https://www.bennadel.com/" & createUuid() );

		attempt {

			directoryCreate( folderPath );

			return( callback( folderPath ) );

		} lastly {

			directoryDelete( folderPath, true );

		}

	}

}

<cfscript>

	// NOTE: I am utilizing RAM disk (Digital File System) because the scratch disk for the picture
	// operations in order that I get quick I/O efficiency.
	generator = new AvatarGenerator()
		.setScratchDisk( "ram://" )
	;

	cfcontent(
		sort = "picture/jpeg",
		variable = generator.generateAvatar( "BN", 120 )
	);

</cfscript>