> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fi/lisaa-aiheita/27-inserting-images.md). # Kuvien lisääminen ## Neljä tapaa lisätä kuvia (luoda LaTeX-kuvia) Overleafissa Vaihtoehdot ovat seuraavat: 1. Käytä [**Lisää kuva** -painiketta](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using_Insert_Figure_to_add_a_figure_to_your_project)(![The Insert Figure button on the editor toolbar](/files/bef8cf45643223bc6c90d79fe3239adacc6e732e)), joka sijaitsee editorin työkalupalkissa, lisätäksesi kuvan **visuaalista editoria** tai **koodieditoria**. 2. [Kopioi ja liitä kuva](/latex/fi/tietopankki/075-how-to-paste-formatted-content-into-overleaf.md#pasting-images-into-your-overleaf-project) sisään **visuaalista editoria** tai **koodieditoria**. 3. Voit luoda kuvan vetämällä ja pudottamalla. Valitse tiedosto paikallisesta tiedostojärjestelmästäsi tai jokin Overleaf-projektiisi ladatuista tiedostoista ja pudota se **visuaalista editoria** tai **koodieditoria**. Overleaf näyttää ikkunan, jossa on vaihtoehtoja kuvan asetusten mukauttamiseen. 4. Käytä **koodieditoria** kirjoittaaksesi LaTeX-koodin, joka lisää grafiikan ja sijoittaa sen figure-ympäristöön. Vaihtoehdot 1, 2 ja 3 luovat automaattisesti kuvan luomiseen tarvittavan LaTeX-koodin, mutta tässä tarkastelemme vaihtoehtoa 4, joka tarjoaa eniten joustavuutta. ## Johdanto Tässä artikkelissa selitämme, miten yleisimmissä muodoissa olevia kuvia lisätään, miten niitä pienennetään, suurennetaan ja käännetään sekä miten niihin viitataan asiakirjassa. Aloitamme esimerkillä, joka osoittaa, miten kuva tuodaan. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {./images/} } \begin{document} Universumi on valtava ja näyttää olevan homogeeninen, suurella mittakaavalla kaikkialla, minne katsomme. \includegraphics{universe} Yllä on kuva galaksista \end{document} ``` ![Esimerkki kuvan lisäämisestä](/files/71fc5a0382f2a1ecf663a552749301494f5d9e67) LaTeX ei voi käsitellä kuvia yksinään, joten meidän on käytettävä `graphicx` pakettia. Sen käyttämiseksi lisäämme seuraavan rivin esipuheeseen: `\usepackage{graphicx}`. Komento `\graphicspath{ {./images/} }` kertoo LaTeXille, että kuvat säilytetään kansiossa nimeltä `images` pääasiakirjan hakemiston alla. Se `\includegraphics{universe}` komento on se, joka varsinaisesti lisäsi kuvan asiakirjaan. Tässä `universe` on kuvatiedoston nimi ilman päätettä, silloin `universe.PNG` muuttuu `universe`. Kuvatiedoston nimessä ei pitäisi olla välilyöntejä eikä useita pisteitä. Huomaa: Tiedostopääte saa olla mukana, mutta se on hyvä jättää pois. Jos tiedostopääte jätetään pois, LaTeX etsii kaikkia tuettuja muotoja. Lisätietoja on osiossa, joka käsittelee [korkea- ja matalaresoluutioisten kuvien luomista](#generating-high-res-and-low-res-images). [Avaa kuviesimerkki Overleafissa](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## Kuvien kansiopolku Kun työskennellään asiakirjan parissa, joka sisältää useita kuvia, nämä kuvat voidaan pitää yhdessä tai useammassa erillisessä kansiossa, jotta projektisi olisi paremmin järjestetty. Komento `\graphicspath{ {images/} }` kertoo LaTeXille etsiä `images` kansiosta. Polku on ***suhteellinen*** nykyiseen työhakemistoon nähden—joten kääntäjä etsii tiedostoa samasta kansiosta kuin koodi, johon kuva on sisällytetty. Kansion polku on oletusarvoisesti suhteellinen, jos alkukansiota ei ole määritetty, esimerkiksi ```latex %Polku suhteessa .tex-tiedostoon, joka sisältää \includegraphics-komennon \graphicspath{ {images/} } ``` Tämä on yleensä suoraviivainen tapa päästä tiedostopuussa grafiikkakansioon, mutta se voi johtaa ongelmiin, kun `.tex` kansioiden sisällä olevia tiedostoja sisällytetään pää `.tex` tiedostoon. Silloin kääntäjä saattaa päätyä etsimään kuvat-kansiota väärästä paikasta. Siksi **on parasta määrittää grafiikkapolku suhteessa pää `.tex` tiedostoa**, joka osoittaa pää `.tex` tiedoston hakemiston `./` , esimerkiksi: ```latex %Polku suhteessa pää .tex-tiedostoon \graphicspath{ {./images/} } ``` kuten johdannossa. Polku voi myös olla ***absoluuttinen***, jos tiedoston tarkka sijainti järjestelmässäsi on määritetty. Esimerkiksi, jos työskentelisit paikallisessa LaTeX-asennuksessa omalla tietokoneellasi: ```latex %Polku Windows-muodossa: \graphicspath{ {c:/user/images/} } %Polku Unix-tyylisessä (Linux, Mac OS) muodossa \graphicspath{ {/home/user/images/} } ``` Huomaa, että tämä komento vaatii loppuun kauttaviivan `/` ja että polku on kaksoissulkeiden välissä. Voit myös asettaa useita polkuja, jos kuvat on tallennettu useampaan kuin yhteen kansioon. Esimerkiksi, jos on kaksi kansiota nimeltä `images1` ja `images2`, käytä komentoa ```latex \graphicspath{ {./images1/}{./images2/} } ``` [Avaa kuviesimerkki Overleafissa](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## Kuvan koon muuttaminen ja kuvan kiertäminen Jos haluamme määrittää tarkemmin, miten LaTeX sisällyttää kuvan asiakirjaan (leveys, korkeus jne.), voimme antaa nämä asetukset seuraavassa muodossa: ```latex \begin{document} Overleaf on erinomainen ammattilaisväline verkkodokumenttien muokkaamiseen, jakaa ja varmuuskopioida \LaTeX{}-projektisi. Tarjoaa myös varsin laajan ohjedokumentaation. \includegraphics[scale=1.5]{overleaf-logo} ``` ![Esimerkki kuvan koon muuttamisesta](/files/fe8a3bd308a9d64049f71d1ab4b91106ab16026e) Komento `\includegraphics[scale=1.5]{overleaf-logo}` sisällyttää kuvan `overleaf-logo` asiakirjaan, lisäparametri `scale=1.5` tekee juuri niin: skaalaa kuvan 1,5-kertaiseksi sen todelliseen kokoon nähden. Voit myös skaalata kuvan tiettyyn leveyteen ja korkeuteen. ```latex \begin{document} Overleaf on erinomainen ammattilaisväline verkkodokumenttien muokkaamiseen, jakaa ja varmuuskopioida \LaTeX{}-projektisi. Tarjoaa myös varsin laajan ohjedokumentaation. \includegraphics[width=5cm, height=4cm]{overleaf-logo} ``` ![Esimerkki kuvan korkeuden ja leveyden asettamisesta](/files/d457bff3134b4b4cea9be268a092fc99a3b6854b) Kuten olet varmaan arvannut, hakasulkeiden sisällä olevat parametrit `[width=3cm, height=4cm]` määrittävät kuvan leveyden ja korkeuden. Voit käyttää [eri yksiköitä](#reference-guide) näille parametreille. Jos vain *leveyttä* parametri annetaan, korkeus skaalataan kuvasuhteen säilyttämiseksi. Pituusyksiköt voivat myös olla suhteessa joihinkin asiakirjan elementteihin. Jos haluat esimerkiksi tehdä kuvasta saman levyisen kuin teksti: ```latex \begin{document} Universumi on valtava ja näyttää olevan homogeeninen, suurella mittakaavalla kaikkialla, minne katsomme. \includegraphics[width=\textwidth]{universe} ``` ![Esimerkki kuvasta asetettuna tekstin levyiseksi](/files/10fed9854109a9e9b88901d5fc433708bf4d3a04) Sen sijaan että `\textwidth` voit käyttää mitä tahansa muuta LaTeXin oletuspituutta: `\columnsep`, `\linewidth`, `\textheight`, `\paperheight`, jne. Katso [viiteopas](#reference-guide) lisätietoja näistä yksiköistä. Toinen yleinen vaihtoehto kuvaa asiakirjaan lisättäessä on sen kiertäminen. Tämä onnistuu helposti LaTeXissa: ```latex \begin{document} Overleaf on erinomainen ammattilaisväline muokata verkossa, jakaa ja varmuuskopioida \LaTeX{}-projektisi. Tarjoaa myös varsin laaja ohjedokumentaation kokoelma. \includegraphics[scale=1.2, angle=45]{overleaf-logo} ``` ![Esimerkki kuvan kiertämisestä](/files/0ca57e2c1d0c20e1f310ccddaa0c914d4f1251a2) Parametri `angle=45` kiertää kuvaa 45 astetta vastapäivään. Kuvan kiertämiseksi myötäpäivään käytä negatiivista lukua. ## Sijoittelu Edellisessä osiossa selitettiin, miten kuvia lisätään asiakirjaan, mutta tekstin ja kuvien yhdistelmä ei ehkä näytä odotetulta. Muuttaaksemme tätä meidän on otettava käyttöön uusi *ympäristö*. ```latex Seuraavassa esimerkissä kuva sijoitetaan juuri tämän lauseen alle. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![Esimerkki kuvien sijoittelusta](/files/c1876a43320ad2bd88ed786054ea8fbb987f11fe) Se `figure` ympäristöä käytetään näyttämään kuvia kelluvina elementteinä asiakirjassa. Tämä tarkoittaa, että lisäät kuvan `figure` ympäristöön, eikä sinun tarvitse huolehtia sen sijoittelusta; LaTeX sijoittaa sen siten, että se sopii asiakirjan kulkuun. Joka tapauksessa joskus tarvitsemme enemmän hallintaa siihen, miten kuvat näytetään. Sijoittelun määrittämiseksi voidaan antaa lisäparametri. Esimerkissä `begin{figure}[h]`, hakasulkeiden sisällä oleva parametri asettaa kuvan sijainniksi ***täällä***. Alla on taulukko mahdollisista sijoitteluarvoista. | Parametri | Sijainti | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Sijoita kelluva elementti *täällä*, eli *suunnilleen* samaan kohtaan, jossa se esiintyy lähdetekstissä (mutta ei *täsmälleen* juuri siihen kohtaan) | | t | Sijoita *yläosaan* sivun. | | b | Sijoita *alaosaan* sivun. | | p | Sijoita erityiselle *page* vain kelluville elementeille tarkoitetulle sivulle. | | ! | Ohita sisäiset parametrit, joita LaTeX käyttää määrittääkseen "hyvät" kelluvien elementtien sijainnit. | | H | Sijoittaa kelluvan elementin täsmälleen siihen kohtaan LaTeX-koodissa. Vaatii `float` paketin, vaikka voi toisinaan aiheuttaa ongelmia. Tämä vastaa jossain määrin h!:ta. | Seuraavassa esimerkissä näet kuvan `t`asiakirjan yläosassa, vaikka se on ilmoitettu tekstin alapuolella. ```latex Tässä kuvassa näet pylväskaavion, joka näyttää kyselyn tulokset, jossa tarkasteltiin joitakin tärkeitä tietoja ajan kuluessa. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![Esimerkki pylväskaaviosta](/files/ba9fefa580ba026503bfcd8f3fb61c5b4b77dffa) Lisäkomento `\centering` keskittää kuvan. Oletusarvoinen tasaus on *left*. ### Tekstin kierrättäminen kuvien ympärille On myös mahdollista **kierrättää** teksti kuvan ympärille. Kun asiakirja sisältää pieniä kuvia, tämä näyttää paremmalta. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %tämä kuva sijoitetaan oikealle \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Kahden muuttujan funktion piirtämiseen on useita tapoja, riippuen siitä, mistä tiedoista olet kiinnostunut. Esimerkiksi, jos haluat nähdä funktion verkon, jotta derivaatta olisi helpompi nähdä, voit käyttää kuvaajaa kuten vasemmalla olevaa. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} Toisaalta, jos olet kiinnostunut vain tietyistä arvoista, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyrä kuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, kuten vasemmalla olevaa. Toisaalta, jos olet kiinnostunut vain tietyistä arvoista, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyrä kuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, voit käyttää korkeuskäyräkuvaajaa, kuten vasemmalla olevaa. ``` ![Esimerkki kuvaajasta](/files/735e3c21fa3d017ebe6a390bca438378837cc311) Jotta esimerkin komennot toimisivat, sinun on tuotava [`wrapfig` paketti](https://ctan.org/pkg/wrapfig?lang=en). Käyttääksesi `wrapfig`, lisää seuraava rivi asiakirjan esipuheeseen: ```latex \usepackage{wrapfig} ``` Tämä tekee `wrapfigure` ympäristön saataville, ja voimme sijoittaa `\includegraphics` komennon sen sisään luodaksemme kuvan, jonka ympärille teksti kiertyy. Näin voimme määrittää *wrapfigure* ympäristöä: ```latex \begin{wrapfigure}[lineheight]{position}{width} ... \end{wrapfigure} ``` Se `sijainti` parametrilla on kahdeksan mahdollista arvoa: | | | | | - | - | ------------------------------------------------------ | | r | R | tekstin oikea puoli | | l | V | tekstin vasen puoli | | i | I | sisäreuna – sidontaa lähellä ( *twoside* asiakirjassa) | | o | O | ulkoreuna – kaukana sidonnasta | Suuraakkosversio sallii kuvan kellumisen. Pienaakkosversio tarkoittaa *täsmälleen tähän*. Nyt voit määrittää `wrapfigure` ympäristön komentojen avulla `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Huomaa, että ympäristöllä on kaksi lisäparametria aaltosulkeissa. Alla koodi selitetään tarkemmin: **{l}** Tämä määrittää kuvan tasauksen. Aseta l vasemmalle ja r oikealle. Lisäksi, jos käytät kirjaa tai vastaavaa muotoa, käytä ulkoreunalle o ja sisäreunalle i. **{0.25\textwidth}** Tämä on kuvaläatikon leveys. Se ei ole itse kuvan leveys; se on asetettava \includegraphics-komennossa. Huomaa, että pituus on suhteessa tekstin leveyteen, mutta myös tavallisia yksiköitä voidaan käyttää (cm, in, mm jne.). Katso viiteoppaasta luettelo yksiköistä. **\centering** Tämä on jo selitetty, mutta tässä esimerkissä kuva keskitetään käyttämällä sen säiliötä viitteenä koko tekstin sijaan. Katso kattavampi artikkeli kuvien sijoittelusta: [Kuvien ja taulukoiden sijoittelu](/latex/fi/kuvat-ja-taulukot/02-positioning-images-and-tables.md) [Avaa kuviesimerkki Overleafissa](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## Kuvatekstien lisääminen, merkitseminen ja viittaaminen Kuvien varustaminen lyhyellä kuvauksella ja merkitseminen myöhempää viittausta varten ovat kaksi tärkeää työkalua työskenneltäessä pitkän tekstin parissa. ### Kuvatekstit Aloitetaan kuvatekstiesimerkillä: ```latex \begin{figure}[h] \caption{Esimerkki parametrikäyrästä ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![Esimerkki parametrikäyrästä](/files/7ed5edb8ce3b7583f437da1f81a374dedcf1ac7a) Se on todella helppoa, lisää vain `\caption{Some caption}` ja kirjoita aaltosulkeiden sisään näytettävä teksti. Kuvatekstin sijoitus riippuu siitä, mihin sijoitat komennon; jos se on `\includegraphics` sen yläpuolella, kuvateksti tulee sen yläpuolelle; jos se on sen alapuolella, kuvateksti asetetaan myös kuvan alapuolelle. Kuvatekstit voidaan sijoittaa myös heti kuvien jälkeen. `sidecap` paketti käyttää tätä varten vastaavaa koodia kuin edellisessä esimerkissä. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %paketti kuvien hallintaan \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Käytetään jälleen kuvaa maailmankaikkeudesta. Tämä kuvateksti tulee oikealle} \includegraphics[width=0.6\textwidth]{universe} \end{SCfigure} ``` ![Esimerkki parametrikäyrästä kuvatekstillä](/files/b6e9e88a7128bd4f113ea35a9f751965a9ea44c5) On kaksi uutta komentoa **\usepackage\[rightcaption]{sidecap}** Kuten odottaa saattaa, tämä rivi tuo käyttöön sidecap-nimisen paketin, mutta siinä on lisäparametri: rightcaption. Tämä parametri määrittää kuvatekstin sijoituksen kuvan oikealle puolelle; voit käyttää myös leftcaptionia. Kirjan kaltaisissa asiakirjoissa ovat käytettävissä myös outercaption ja innercaption. Nimet kertovat itse puolestaan. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Määrittää figure-ympäristöä vastaavan ympäristön. Ensimmäinen parametri on kuvatekstin leveys suhteessa kuvan kokoon, kuten \includegraphicsissa on ilmoitettu. Toinen parametri h toimii aivan kuten figure-ympäristössä. Katso sijoitteluosiosta lisätietoja. Voit hallita kuvatekstin muotoilua edistyneemmin. Katso [lisälukemista](#further-reading) osiosta viitteitä. ### Tunnisteet ja ristiviitteet Kuvia, aivan kuten monia muitakin LaTeX-asiakirjan elementtejä (yhtälöitä, taulukoita, kuvaajia jne.), voidaan viitata tekstissä. Tämä on hyvin helppoa, lisää vain `\label` tunniste `figure` tai `SCfigure` ympäristöön, ja käytä myöhemmin tätä tunnistetta viitataksesi kuvaan. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{a nice plot} \label{fig:mesh1} \end{figure} Kuten näet kuvasta \ref{fig:mesh1}, funktio kasvaa lähellä nollaa. Myös sivulla \pageref{fig:mesh1} on sama esimerkki. ``` ![Esimerkki kuvasta tunnisteella](/files/a2076e06846b9f25f692650add13cf8b9575fdde) Tässä esimerkissä on kolme komentoa, jotka luovat ristiviitteet. **\label{fig:mesh1}** Tämä asettaa tunnisteen tälle kuvalle. Koska tunnisteita voidaan käyttää useissa asiakirjan elementtityypeissä, on hyvä käyttää etuliitettä, kuten esimerkissä fig:. **\ref{fig:mesh1}** Tämä komento lisää kuvalle annetun numeron. Se luodaan automaattisesti ja päivittyy, jos lisäät jonkin muun kuvan ennen viitattua kuvaa. **\pageref{fig:mesh1}** Tämä tulostaa sivunumeron, jolla viitattu kuva esiintyy. Se `\caption` on pakollinen kuvan viittaamiseen. Toinen hieno ominaisuus LaTeX-asiakirjassa on mahdollisuus luoda automaattisesti *kuvaluettelo*. Tämä on suoraviivaista. ```latex \listoffigures ``` ![Esimerkki kuvaluettelosta](/files/2f9f5d128d3a3b18a61fc345b2aeb51e3b41a317) Tämä komento toimii vain kuvissa, joissa on kuvateksti, koska se käyttää taulukossa kuvatekstiä. Yllä oleva esimerkki luettelee tämän artikkelin kuvat. Tärkeä huomautus: Ristiviitteitä käytettäessä LaTeX-projekti on käännettävä kahdesti, muuten viitteet, sivuviitteet ja kuvaluettelo eivät toimi—Overleaf huolehtii siitä puolestasi. ## Korkea- ja matalaresoluutioisten kuvien luominen Toistaiseksi, kun olemme määrittäneet kuvatiedoston nimen `\includegraphics` komennossa, olemme jättäneet tiedostopäätteet pois. Se ei kuitenkaan ole välttämätöntä, vaikka siitä on usein hyötyä. Jos tiedostopääte jätetään pois, LaTeX etsii hakemistosta mitä tahansa tuettua kuvamuotoa ja etsii useita päätteitä oletusjärjestyksessä (jota voidaan muuttaa). Tästä on hyötyä vaihdettaessa kehitys- ja tuotantoympäristöjen välillä. Kehitysympäristössä (kun artikkeli/raportti/kirja on vielä työn alla) on suositeltavaa käyttää kuvien matalaresoluutioisia versioita (tyypillisesti .png-muodossa) esikatselun nopeaa kääntämistä varten. Tuotantoympäristössä (kun artikkelin/raportin/kirjan lopullinen versio tuotetaan) on suositeltavaa sisällyttää kuvista korkearesoluutioinen versio. Tämä saavutetaan * sillä, että tiedostopäätettä ei määritetä *\includegraphics* komennossa, ja * määritetään haluttu pääte esipuheessa. Niinpä jos meillä on kaksi versiota kuvasta, venndiagram.pdf (korkearesoluutioinen) ja venndiagram.png (matalaresoluutioinen), voimme lisätä seuraavan rivin esipuheeseen käyttääksesi .png-versiota raporttia kehitettäessä - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` Yllä oleva komento varmistaa, että jos löydetään kaksi tiedostoa, joilla on sama perusnimi mutta eri päät­teet (esimerkiksi venndiagram.pdf ja venndiagram.png), .png-versiota käytetään ensin, ja sen puuttuessa käytetään .pdf-versiota; tämä on myös hyvä idea, jos joitakin matalaresoluutioisia versioita ei ole saatavilla. Kun raportti on kehitetty valmiiksi, voimme käyttää korkearesoluutioista .pdf-versiota muuttamalla esipuheessa olevaa päätteiden hakujärjestystä määrittävää riviä muotoon ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Edellisissä kappaleissa kuvatun tekniikan parantamiseksi voimme myös ohjeistaa LaTeXin luomaan matalaresoluutioisia .png-versioita kuvista lennossa asiakirjaa käännettäessä, jos on PDF, jota ei ole vielä muunnettu PNG:ksi. Tämän saavuttamiseksi voimme lisätä seuraavan esipuheeseen jälkeen `\usepackage{graphicx}` ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Jos venndiagram2.pdf on olemassa mutta venndiagram2.png ei ole, tiedosto venndiagram2-pdf-converted-to.png luodaan ja ladataan sen paikalle. Komento *convert #1* vastaa muunnoksesta, ja lisäparametreja voidaan antaa *convert* ja *#1*. Esimerkiksi - *convert -density 100 #1*. On kuitenkin muutamia tärkeitä asioita pidettävä mielessä: * Automaattisen muunnoksen toimimiseksi meidän on kutsuttava *pdflatex* määrittelyyn `--shell-escape` vaihtoehto. * Lopullista *tuotanto* versiota varten meidän on kommentoitava pois `\epstopdfDeclareGraphicsRule`, jotta vain korkearesoluutioiset PDF-tiedostot ladataan. Meidän on myös muutettava etusijajärjestystä. [Avaa kuviesimerkki Overleafissa](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## Viiteopas **LaTeXin yksiköt ja pituudet** | Lyhenne | Määritelmä | | ------------ | -------------------------------------------- | | pt | Piste on oletuspituusyksikkö. Noin 0,3515 mm | | mm | millimetri | | cm | senttimetri | | tiedostoihin | tuuma | | ex | x-kirjaimen **korkeus** nykyisessä fontissa | | em | kirjaimen **m** nykyisessä fontissa | | \columnsep | sarakkeiden välinen etäisyys | | \columnwidth | sarakkeen leveys | | \linewidth | rivin leveys nykyisessä ympäristössä | | \paperwidth | sivun leveys | | \paperheight | sivun korkeus | | \textwidth | tekstin leveys | | \textheight | tekstin korkeus | | \unitlength | pituusyksiköt *picture* ympäristössä. | **Tietoa kuvatyypeistä LaTeXissa** **latex** Käännettäessä latexilla voimme käyttää vain EPS-kuvia, jotka ovat vektorimuotoisia. **pdflatex** Jos käännämme "pdflatexilla" PDF:n tuottamiseksi, voimme käyttää useita kuvamuotoja - ``` JPG: Paras valinta, jos haluamme lisätä valokuvia PNG: Paras valinta, jos haluamme lisätä kaavioita (jos vektoriversiota ei voitu luoda) ja kuvakaappauksia PDF: Vaikka olemme tottuneet näkemään PDF-asiakirjoja, PDF voi myös sisältää kuvia EPS: EPS-kuvia voidaan sisällyttää epstopdf-paketilla (meidän tarvitsee vain asentaa paketti, me emme tarvitse käyttää \usepackage{}-komentoa sisällyttääksemme sen asiakirjaamme.) ``` **Vektori- vai bittikarttamuoto?** Kuvat voivat olla joko vektori- tai bittikarttamuodossa. Yleensä siitä ei tarvitse huolehtia, mutta jos tiedämme, missä muodossa kuva on, voimme käyttää tätä tietoa valitaksemme sopivan kuvamuodon LaTeX-asiakirjaamme. Jos kuva on vektorimuotoinen, meidän kannattaa valita PDF tai EPS. Jos se on bittikarttamuotoinen, meidän kannattaa valita JPG tai PNG, koska bittikarttakuvien tallentaminen PDF- tai EPS-muodossa vie paljon levytilaa. [Avaa kuviesimerkki Overleafissa](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## Lisälukemista Lisätietoja on kohdassa * [Kuvien ja taulukoiden sijoittelu](/latex/fi/kuvat-ja-taulukot/02-positioning-images-and-tables.md) * [Taulukkojen ja kuvioiden luettelot](/latex/fi/kuvat-ja-taulukot/03-lists-of-tables-and-figures.md) * [Yksipuoliset ja kaksipuoliset asiakirjat](/latex/fi/muotoilu/08-single-sided-and-double-sided-documents.md) * [Pituudet LaTeXissa](/latex/fi/muotoilu/01-lengths-in-latex.md) * [**floatrow** paketti kelluvien elementtien (taulukoiden ja kuvien) edistyneeseen kuvatekstien hallintaan](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** paketin dokumentaatio, sivukuvatekstejä varten](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** paketin dokumentaatio (EPS:n muunnos PDF:ksi)](https://ctan.org/pkg/epstopdf?lang=en) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fi/lisaa-aiheita/27-inserting-images.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.