# Last edited on 2023-12-31 10:52:28 by stolfi

# Makefile for animation labs
# To be included in a Makefile
# The Makefile must define ${WIDTH} ${HEIGHT} ${ICONWIDTH} ${ICONHEIGHT}

SHELL := /bin/bash

# Large image size (e.g. still frames and "make movie"):
FULLWIDTH := ${WIDTH}
FULLHEIGHT := ${HEIGHT}

# Medium image size (for "make fast"):
MEDWIDTH := ${shell echo "${WIDTH}/2" | bc -lq }
MEDHEIGHT := ${shell echo "${HEIGHT}/2" | bc -lq }

# Small image size (e.g. for film strips):
SMALLWIDTH := ${ICONWIDTH}
SMALLHEIGHT := ${ICONHEIGHT}

OTHERINPUTS := ${wildcard *.inc pic-*.{png.jpg,JPG}}

# Automatic "make showXXX" after "make XXX":
SHOW := NO

ROOTNAME = main
POVFILE := ${ROOTNAME}.pov

# POV-Ray installation directories:
POVRAY := /usr/bin/povray
POVINC := /usr/share/povray-3.7/include/

TOPDIR := ../../..
POVTTF := tt-fonts
POVFILTER := mc937_povray_error_filter.gawk
# POVFILTER := cat 

# Note: defined with "=" rather than ":="
DIRTAIL = ${shell pwd | sed -e 's:^.*/::'}
IMVIEW = display -title "${DIRTAIL}/%f"

.PHONY: \
  all \
  print-help \
  clean \
  first showfirst \
  middle showmiddle \
  last showlast \
  strip showstrip \
  fast \
  movie \
  still showstill \
  frame showframe

all: print-help

print-help:
	@-echo "Voce deve executar 'make <ALGO>'"
	@-echo ""
	@-echo "  'make first'                 Primeiro quadro (clock = 0.0000)."
	@-echo "  'make middle'                Quadro do meio (clock = 0.5000)."
	@-echo "  'make last'                  Quadro final (clock = 1.0000)."
	@-echo "  'make CLOCK={N.NNNN} still'  Quadro com esse clock."
	@-echo ""
	@-echo "  'make strip'                 Tira com vários quadros."
	@-echo ""
	@-echo "  'make fast'                  Filme GIF com tela pequena e poucos quadros."
	@-echo "  'make movie'                 Filme GIF com tela maior e mais quadros."   
	@-echo ""
	@-echo "  'make clean'                 Remove imagens geradas."

# ----------------------------------------------------------------------
# Generic showXXX - caller must define ${PNGFILE}:
ifneq "/${PNGFILE}" "/"

showimage: 
	@if [[ -s ${PNGFILE} ]]; then \
          ${IMVIEW} ${PNGFILE} ; \
        else \
          echo "** file ${PNGFILE} not found" 1>&2 ; exit 1 ; \
        fi
        
endif
# ----------------------------------------------------------------------

# Still frames

STILLWIDTH := ${FULLWIDTH}
STILLHEIGHT := ${FULLHEIGHT}
STILLRAYS := 2

# "make first" creates the first frame of the movie:
#
first: 
	${MAKE} CLOCK=0.0000 still;
	@if [[ "/${SHOW}" == "/YES" ]]; then ${MAKE} showfirst; fi
        
showfirst:
	${MAKE} PNGFILE=${ROOTNAME}-0.0000.png showimage

# "make middle" creates the middle frame of the movie:
#
middle: 
	${MAKE} CLOCK=0.5000 still;
	@if [[ "/${SHOW}" == "/YES" ]]; then ${MAKE} showmiddle; fi
        
showmiddle:
	${MAKE} PNGFILE=${ROOTNAME}-0.5000.png showimage

# "make last" creates the last frame of the movie:
#

last: 
	${MAKE} CLOCK=1.000 still;
	@if [[ "/${SHOW}" == "/YES" ]]; then ${MAKE} showlast; fi
        
showlast:
	${MAKE} PNGFILE=${ROOTNAME}-1.000.png showimage

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# "make strip" creates a strip with several frames:

STRIPNAME := ${ROOTNAME}-s
STRIPPNG := ${STRIPNAME}.png

STRIPWIDTH := 240
STRIPHEIGHT := 240
STRIPRAYS := 1

STRIPCLOCKS := \
    0.0000 0.0714 0.1429 0.2143 0.2857 \
    0.3571 0.4286 0.5000 0.5714 0.6429 \
    0.7143 0.7857 0.8571 0.9286 1.0000
    
STRIPFRAMES := ${addprefix ${STRIPNAME}-,${addsuffix .png,${STRIPCLOCKS}}}

strip: ${STRIPPNG}
	@if [[ "/${SHOW}" == "/YES" ]]; then ${MAKE} showstrip; fi

${STRIPPNG}: ${POVFILE} ${OTHERINPUTS}
	/bin/rm -f ${STRIPPNG} 
	for clock in ${STRIPCLOCKS} ; do \
          ${MAKE} FRAMEROOTNAME=${STRIPNAME} CLOCK=$$clock \
            WIDTH=${STRIPWIDTH} HEIGHT=${STRIPHEIGHT} \
            NRAYS=${STRIPRAYS} FRAMESHOWOP='+D' BORDER=1 \
            frame; \
        done
	mc937_tile_movie_frames.sh \
          -ncols 5 \
          ${STRIPPNG} \
          ${STRIPFRAMES}

showstrip:
	${MAKE} PNGFILE=${STRIPPNG} showimage

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# "make fast" creates a movie with 24 medium-size frames at speed × 4.

FASTNAME := ${ROOTNAME}-f
FASTGIF := ${FASTNAME}.gif

FASTWIDTH := ${MEDWIDTH}
FASTHEIGHT := ${MEDHEIGHT}
FASTRAYS := 1

# Parameters for 24 frames, high-speed
FASTDELAY := 15
FASTCLOCKS := \
  0.0000 0.0417 0.0833 0.1250 0.1667 \
  0.2083 0.2500 0.2917 0.3333 0.3750 \
  0.4167 0.4583 0.5000 0.5417 0.5833 \
  0.6250 0.6667 0.7083 0.7500 0.7917 \
  0.8333 0.8750 0.9167 0.9583
    
FASTFRAMES := ${addprefix ${FASTNAME}-,${addsuffix .png,${FASTCLOCKS}}}

fast: ${FASTGIF}

${FASTGIF}: ${POVFILE} ${OTHERINPUTS}
	/bin/rm -f ${FASTGIF}
	for clock in ${FASTCLOCKS} ; do \
          ${MAKE} FRAMEROOTNAME=${FASTNAME} CLOCK=$$clock \
            WIDTH=${FASTWIDTH} HEIGHT=${FASTHEIGHT} \
            NRAYS=${FASTRAYS} FRAMESHOWOP='-D' \
            frame; \
        done
	mc937_animate_movie_frames.sh \
          -delay ${FASTDELAY} \
          ${FASTGIF} \
          ${FASTFRAMES}
	@-echo "----------------------------------------------------------------------"
	@-echo "To watch the movie, open ${FASTGIF} with a browser."
	@-echo "----------------------------------------------------------------------"

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# "make movie" creates a movie with many frames, normal speed.

MOVIEWIDTH := ${FULLWIDTH}
MOVIEHEIGHT := ${FULLHEIGHT}
MOVIERAYS := 2

MOVIENAME := ${ROOTNAME}-m

# Parameters for 50 frames:
# MOVIEDELAY := 10
# MOVIECLOCKS := \
#   0.0000 0.0200 0.0400 0.0600 0.0800 \
#   0.1000 0.1200 0.1400 0.1600 0.1800 \
#   0.2000 0.2200 0.2400 0.2600 0.2800 \
#   0.3000 0.3200 0.3400 0.3600 0.3800 \
#   0.4000 0.4200 0.4400 0.4600 0.4800 \
#   0.5000 0.5200 0.5400 0.5600 0.5800 \
#   0.6000 0.6200 0.6400 0.6600 0.6800 \
#   0.7000 0.7200 0.7400 0.7600 0.7800 \
#   0.8000 0.8200 0.8400 0.8600 0.8800 \
#   0.9000 0.9200 0.9400 0.9600 0.9800
  
# Parameters for 80 frames:
# MOVIEDELAY := 6
# MOVIECLOCKS := \
#   0.0000 0.0125 0.0250 0.0375 0.0500 0.0625 0.0750 0.0875 \
#   0.1000 0.1125 0.1250 0.1375 0.1500 0.1625 0.1750 0.1875 \
#   0.2000 0.2125 0.2250 0.2375 0.2500 0.2625 0.2750 0.2875 \
#   0.3000 0.3125 0.3250 0.3375 0.3500 0.3625 0.3750 0.3875 \
#   0.4000 0.4125 0.4250 0.4375 0.4500 0.4625 0.4750 0.4875 \
#   0.5000 0.5125 0.5250 0.5375 0.5500 0.5625 0.5750 0.5875 \
#   0.6000 0.6125 0.6250 0.6375 0.6500 0.6625 0.6750 0.6875 \
#   0.7000 0.7125 0.7250 0.7375 0.7500 0.7625 0.7750 0.7875 \
#   0.8000 0.8125 0.8250 0.8375 0.8500 0.8625 0.8750 0.8875 \
#   0.9000 0.9125 0.9250 0.9375 0.9500 0.9625 0.9750 0.9875

# Parameters for 100 frames:
MOVIEDELAY := 3
MOVIECLOCKS := \
  0.0000 0.0100 0.0200 0.0300 0.0400 0.0500 0.0600 0.0700 0.0800 0.0900 \
  0.1000 0.1100 0.1200 0.1300 0.1400 0.1500 0.1600 0.1700 0.1800 0.1900 \
  0.2000 0.2100 0.2200 0.2300 0.2400 0.2500 0.2600 0.2700 0.2800 0.2900 \
  0.3000 0.3100 0.3200 0.3300 0.3400 0.3500 0.3600 0.3700 0.3800 0.3900 \
  0.4000 0.4100 0.4200 0.4300 0.4400 0.4500 0.4600 0.4700 0.4800 0.4900 \
  0.5000 0.5100 0.5200 0.5300 0.5400 0.5500 0.5600 0.5700 0.5800 0.5900 \
  0.6000 0.6100 0.6200 0.6300 0.6400 0.6500 0.6600 0.6700 0.6800 0.6900 \
  0.7000 0.7100 0.7200 0.7300 0.7400 0.7500 0.7600 0.7700 0.7800 0.7900 \
  0.8000 0.8100 0.8200 0.8300 0.8400 0.8500 0.8600 0.8700 0.8800 0.8900 \
  0.9000 0.9100 0.9200 0.9300 0.9400 0.9500 0.9600 0.9700 0.9800 0.9900

MOVIEFRAMES := ${addprefix ${MOVIENAME}-,${addsuffix .png,${MOVIECLOCKS}}}

movie: ${MOVIENAME}.gif

${MOVIENAME}.gif: ${POVFILE} ${OTHERINPUTS}
	/bin/rm -f ${MOVIENAME}.gif
	for clock in ${MOVIECLOCKS} ; do \
          ${MAKE} FRAMEROOTNAME=${MOVIENAME} CLOCK=$$clock \
            WIDTH=${MOVIEWIDTH} HEIGHT=${MOVIEHEIGHT} \
            NRAYS=${MOVIERAYS} FRAMESHOWOP='-D' \
            frame; \
        done
	mc937_animate_movie_frames.sh \
          -delay ${MOVIEDELAY} \
          ${MOVIENAME}.gif \
          ${MOVIEFRAMES}
	@-echo "----------------------------------------------------------------------"
	@-echo "To watch the movie, open ${MOVIENAME}.gif with a browser."
	@-echo "----------------------------------------------------------------------"

######################################################################
# Commands for a specific frame:
# Caller must define ${CLOCK}.
#

CLOCK := CLOCK.IS.UNDEFINED
ifneq "${CLOCK}" "CLOCK.IS.UNDEFINED"

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# "make still CLOCK=N.NNNN" creates a frame with specified clock value:
#
STILLNAME := ${ROOTNAME}

still: 
	${MAKE} ROOTNAME=${ROOTNAME} \
          FRAMEROOTNAME=${STILLNAME} CLOCK=`printf "%6.4f" ${CLOCK}`  \
          WIDTH=${STILLWIDTH} HEIGHT=${STILLHEIGHT} \
          NRAYS=${STILLRAYS} FRAMESHOWOP='+D' \
          frame 

######################################################################
# General-purpose commands used by the above:
# Caller must define ${CLOCK}, ${FRAMEROOTNAME}, ${WIDTH}, ${HEIGHT}, ${NRAYS}.
# ${FRAMEROOTNAME} is the frame image file name minus "-${CLOCK}" and the extension.
#
FRAMEROOTNAME := FRAMEROOTNAME.IS.UNDEFINED
ifneq "${FRAMEROOTNAME}" "FRAMEROOTNAME.IS.UNDEFINED"
WIDTH := WIDTH.IS.UNDEFINED
ifneq "${WIDTH}" "WIDTH.IS.UNDEFINED"
HEIGHT := HEIGHT.IS.UNDEFINED
ifneq "${HEIGHT}" "HEIGHT.IS.UNDEFINED"
NRAYS := NRAYS.IS.UNDEFINED
ifneq "${NRAYS}" "NRAYS.IS.UNDEFINED"

FRAMENAME := ${FRAMEROOTNAME}-${CLOCK}
FRAMEPNG := ${FRAMENAME}.png

FRAMEBORDER := 0
FRAMESHOWOP := -D

frame: ${FRAMEPNG}

${FRAMEPNG}: ${POVFILE} ${OTHERINPUTS}
	@echo "OTHERINPUTS = ${OTHERINPUTS}"
	-/bin/rm -f ${FRAMEPNG}
	${POVRAY} +K${CLOCK} \
            +FN +Q9 \
            +W${WIDTH} +H${HEIGHT} \
            +AM1 +A0.0 +R${NRAYS} \
            ${FRAMESHOWOP} \
            +L${POVINC} \
            +L${POVTTF} \
	    +I${POVFILE} \
	    +O${FRAMEPNG} \
          2>&1 \
          | ${POVFILTER}

endif
endif
endif
endif
# End ${FRAMENAME}, ${WIDTH}, ${HEIGHT}, ${NRAYS} section
######################################################################

endif
# End ${CLOCK} section
######################################################################

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# "make clean" removes all created files
# Take care not to remove "*-orig.*"

clean::
	-/bin/rm -f ${ROOTNAME}.log ${ROOTNAME}-*.log
	-/bin/rm -f ${ROOTNAME}-[01].[0-9][0-9][0-9][0-9].png
	-/bin/rm -f ${STRIPPNG} ${STRIPNAME}-[01].[0-9][0-9][0-9][0-9].png
	-/bin/rm -f ${FASTGIF} ${FASTNAME}-[01].[0-9][0-9][0-9][0-9].png
	-/bin/rm -f ${MOVIENAME}.gif ${MOVIENAME}-[01].[0-9][0-9][0-9][0-9].png
	-/bin/rm -f ${ROOTNAME}-i.png ${ROOTNAME}-*-i.png