Please add instructions for Retina displays.

[mcourteaux]

The image in the main README showcases a screenshot of a retina display with a figure displayed inline in iTerm2. How to do this? All my attempts result in pixelated images.

[daleroberts]

I'm not quite sure what you are asking, could you supply a screenshot of the problem?

[mcourteaux]

Go ahead and pixel peep at it at 1:1 scaling. Text is nice and smooth, using full retina abilities, whereas the image is pixelated, due to retina not being scaled. The exact same happens with itermplot figures: they are not retina. You somehow were able to make them retina, as is shown in the screenshot in the main README.

Look here:

And zoomed in:

[daleroberts]

Currently, itermplot defaults to generating PDF images for transfer to iTerm2 and there seems to be a bug in iTerm2 around retina rendering that is now fixed in the beta and nightly builds. See here.

Alternatively, you can set export ITERMPLOT_PLOTFILE="plot.png" to use the PNG backend. This should help achieve what you want and then you can also tweak the DPI settings. See here.