Changelog • webmorphR

webmorphR 0.1.1

CRAN release: 2022-06-02

Fixed a bug when cropping blank() images with no names
Fixed a bug when using image_func() with func = “composite” and the length of the stimuli and composite image are the same.

R version requirements decreased from 4.2.0 to 4.1.0
quick_delin() function changed to delin() and upgraded to be able to update full templates
delin() lets you adjust full templates now, but is still very experimental.
Split demo_stim() into demo_stim() and demo_tems() and removed set argument.
Changed to as_stimlist() from validate_stimlist()
The expand argument in mask() works now and also does contraction with negative values.
rotate() has a new argument, origin, that customises the rotation origin
patch() now converts pixel colours to CIE-L*ab values before taking the mean or median values, which should create closer visual matches than the old RGB method. Also changed from taking x and y max and min values to width, height, x_off and y_off (like crop()).
Prepared for CRAN

Changed patch() function to return a vector of hex colours for a stimlist
Removed patch argument from crop(), rotate(), to_size() and pad(); use patch() to generate values for the fill argument instead.
Various code optimisations and bug fixes.
Made most of the helper functions internal; I don’t think anyone else uses these.
Changed name of image_comp() to compare()
Changed name of setnames() to rename_stim()
align() now takes a stim or stimlist as ref_img, in addition to the index or name of an item in stimuli.
New centroid() function for finding the mean x and y coordinates of each template in a stimlist.

Removed ask argument from write_stim() and added “overwrite” to wm_opts() for a global overwrite setting.
Added wm_opts_defaults() function to get all default option values.
write_stim() now can get the image format from the name argument, if it ends in .jpg, .jpeg, .png, or .gif (case insensitive). This overrides the format argument.
Moved most demo_stim() (except “test” and “tem_examples”) into new webmorphR.stim::load_stim() functions.
Minor bug fixes.

moved all python functions to webmorphR.dlib
auto_delin() is now a wrapper for fpp_auto_delin() (for Face++) and webmorphR.dlib::dlib_auto_delin() (for python/dlib/face_recognition delineations).
Manuals and vignettes updated

Reduced package dependencies, but now requires R>=4.2.0
All code and examples use |> pipe
facetrain() function for training a dlib shape predictor model (still really experimental)
Various bug fixes

Fixed bug in mask_oval() when setting bounds manually that had reversed top and bottom values.
trans() now returns images in a more sensible order.
added ability to rename images to write_stim()
to_size() crop argument added.
Images from plot() displayed in the correct aspect ratio in RMarkdown files by default now.

demo imagesets removed so demo_stim() needs to load “london”, “smiling”, “composite”, “lisa”, “zoom”, and “rainbow” from webmorphR.stim using remotes::install_github("debruine/webmorphR.stim")
image_comp() to calculate difference between images in a way that corresponds to morph continuua differences
crop_pad renamed to crop_tem()
frl_features renamed to features()
as always, bug fixes too numerous to mention

Deleted all of the webmorph.org functions that required login
Added webmorph functions that don’t require login: avg(), trans(), continuum(), loop()

Fixed some minor bugs
Fixed bug in converting rgb(a) values to hex when all values < 10
Added ability to set background in grid_stim() and plot()
draw_tem() takes a background color for bg now
Added plot_size() function to return size of last plot and a string to paste into Rmd chunks.

Broke all the plotting, but the new plot() function is much better and faster
Added convenience functions: pad(), draw_tem(), grid_stim(), save_plot()
Renamed functions
- oval_mask => mask_oval()
- faces => demo_stim()
- auto_delineate => auto_delin()
Fixed function examples

Bug fixes for stimuli that have no templates
to_size() now takes a vector of width and height, so you can more easily use it with social_media_size()
write_stim() now lets you change format (png, jpeg, or gif)